@stratakit/foundations v0.1.5
@stratakit/foundations
Foundational pieces of StrataKit.
This package includes:
- CSS reset and global styles
- Design tokens, exposed as "CSS variables".
<Root>component<Icon>component
Installation
Using your package manager of choice, install the latest version of @stratakit/foundations.
npm add @stratakit/foundations
@stratakit/foundationsis a peer dependency of all@stratakitpackages, and should only be installed once by the final applications. Any packages built on top of@stratakitshould not specify@stratakit/foundationsas a direct dependency.
Usage
To use StrataKit in your app, you’ll need to wrap your application's entrypoint with StrataKit's <Root> component, which requires the colorScheme and density props.
import { Root } from "@stratakit/foundations";
export function App() {
return (
<Root colorScheme="dark" density="dense">
{/* Use StrataKit components here */}
</Root>
);
}This will ensure StrataKit's styles are loaded to either the document or the encompassing shadow root.
Once that’s in place, you can import and use components from @stratakit/bricks and other @stratakit packages.
!NOTE If you are trying to use this package alongside the current stable version of iTwinUI, you will also need to set up the iTwinUI theme bridge.
Fonts
StrataKit uses InterVariable as its interface font. In the future, other fonts may also be added for different purposes. We recommend self-hosting all fonts for robustness, security and performance reasons.
To self-host InterVariable, download the InterVariable.woff2 and InterVariable-Italic.woff2 font files from the official website, and serve them alongside your other assets. Then include the following CSS in the <head> of your document, replacing the placeholder paths with the correct path to where the fonts are located:
<style>
@font-face {
font-family: InterVariable;
font-style: normal;
font-weight 100 900;
font-display: swap;
src: url("/path/to/InterVariable.woff2") format("woff2");
}
@font-face {
font-family: InterVariable;
font-style: italic;
font-weight 100 900;
font-display: swap;
src: url("/path/to/InterVariable-Italic.woff2") format("woff2");
}
</style>Build tools such as Vite can handle url() references and automatically copy these files into your output directory with hashed file names. These files can then be safely served with HTTP caching without blocking upgrades to newer versions of the fonts.
!NOTE If the
<Root>component cannot findInterVariableas a font in the document, it will automatically add a fallback which uses Inter’s CDN. In all cases, we recommend self-hosting to avoid any potential security and reliability issues that may arise from the use of a third-party CDN.
Contributing
Are you interested in helping StrataKit grow? You can submit feature requests or bugs by creating issues.
If you're interested in contributing code, please read CONTRIBUTING.md for more information.