React Router
Set up Lampung Design System in a React Router project.
New project
Create a new React Router project that already uses LDS in one step:
npx lampung-ds@latest create kota-contoh -t react-router
Existing project
Run it in the project folder. It is safe to repeat: run it twice and nothing changes the second time.
npx lampung-ds@latest init
What the CLI changes
app/app.css | global stylesheet: imports lampung-design-system/css |
app/root.tsx | the <html> element: lds class, lang, data-theme |
app/components/lds-provider.tsx | interactive behaviors: init() and the saved theme |
lds.json | CLI settings for the add command |
Manual setup
Prefer to wire it yourself? These are the same steps the CLI runs.
1. Install the package
npm install lampung-design-system
2. Import the CSS
/* app/app.css */ @import "lampung-design-system/css";
3. Mark the root element
// app/root.tsx
export function Layout({ children }: { children: React.ReactNode }) {
return (
<html lang="id" className="lds" data-theme="light" suppressHydrationWarning>
<head><Meta /><Links /></head>
<body className="lds">
<LdsProvider>{children}</LdsProvider>
<ScrollRestoration />
<Scripts />
</body>
</html>
);
}4. Turn on the interactive behaviors
// app/components/lds-provider.tsx
'use client';
import { useEffect } from 'react';
import { init, restoreTheme } from 'lampung-design-system/js';
export function LdsProvider({ children }: { children: React.ReactNode }) {
useEffect(() => {
restoreTheme(document.documentElement, 'light');
init();
}, []);
return <>{children}</>;
}First component
Add components to your project. The CLI copies tested markup into your components folder, ready to edit.
npx lampung-ds@latest add button text-field alert
Next steps
- Read every CLI command.
- Browse the component list before building something new.
- Set up theming and agency colors.