68 lines
1.7 KiB
Markdown
68 lines
1.7 KiB
Markdown
# Methanium UI
|
|
|
|
```sh
|
|
pnpm install https://git.methanium.net/methanium/ui/releases/download/latest/methanium-ui.tgz
|
|
```
|
|
|
|
Import the stylesheet once, then add the provider at the application root:
|
|
|
|
```tsx
|
|
import "@methanium/ui/index.css";
|
|
import { ThemeProvider } from "@methanium/ui";
|
|
|
|
<ThemeProvider>{children}</ThemeProvider>;
|
|
```
|
|
|
|
## App Default
|
|
|
|
Vite applications can choose their initial parent theme at build time:
|
|
|
|
```ts
|
|
import { methaniumUi } from "@methanium/ui/vite";
|
|
|
|
export default defineConfig({
|
|
plugins: [methaniumUi({ defaultThemeId: "tensamin" })],
|
|
});
|
|
```
|
|
|
|
The built-in parent themes are `tensamin`, `og-tensamin`, `methanium`, and
|
|
`secret`. Without the plugin or a provider override, the neutral base theme is
|
|
used.
|
|
Public Sans is bundled as the default typeface; users can switch to their
|
|
platform's system font in the customizer.
|
|
|
|
## Custom Themes
|
|
|
|
Pass a typed manifest to `ThemeProvider` to add themes. Presets are ordinary
|
|
CSS and remain fully editable after selection.
|
|
|
|
```ts
|
|
import {
|
|
BUILT_IN_THEMES,
|
|
DEFAULT_THEME_DESIGN,
|
|
defineThemes,
|
|
} from "@methanium/ui";
|
|
|
|
export const themes = defineThemes([
|
|
...BUILT_IN_THEMES,
|
|
{
|
|
id: "my-theme",
|
|
title: "My Theme",
|
|
logo: "/themes/my-logo.svg",
|
|
defaultValues: {
|
|
borderRadius: 0.5,
|
|
design: { ...DEFAULT_THEME_DESIGN, density: 0.95 },
|
|
},
|
|
css: `:root[data-theme="my-theme"] { --primary: #ff4f91; }`,
|
|
},
|
|
]);
|
|
```
|
|
|
|
Use `<ThemeCustomizer />` for all theme editing. `<ThemeSelector />` is its
|
|
focused parent-theme selection control.
|
|
|
|
## Onboarding
|
|
|
|
Every `OnboardingStep` requires a `title`; the flow owns title rendering and
|
|
focus. `<ThemeOnboardingPage />` applies choices immediately and prevents
|
|
continuing until the user explicitly selects a theme.
|