Design systems
You can create a central design system project in Lovable to share your brand colors, fonts, and reusable UI components across all your apps. Once connected, your apps automatically receive those building blocks and stay in sync whenever you publish an update.
Anyone managing multiple apps in a workspace who needs a consistent look and reusable components across every project.
Do this, in order
- 1
In the Lovable prompt box, click the plus (+) menu, select Design, choose Use a design system, and click Create design system.
This creates a dedicated project that serves as the single source of truth for your brand styles and components.
- 2
In the design system project chat, share your public Git repository URL, provide an npm package name, upload component files, or instruct Lovable to create components from scratch.
Lovable needs your code and design assets in the project to extract reusable rules and elements.
- 3
Click Release version inside the design system project.
Publishing generates the rule files and component catalog so other projects can discover and use the design system.
- 4
In your app project, click the plus (+) button next to the chat input, select Project, choose Design system, and click Attach design system to pick your library.
Lovable copies the design system components into your app, sets up dependencies, and automatically verifies that styling is working.
- 5
Click to accept the Update available prompt in your app chat whenever a new version of the design system is published.
This refreshes your components and rules to the latest version without modifying your app-specific code.
Paste this into your project
Set up a clean design system project with our brand design tokens (primary, secondary, neutral colors, typography, spacing, and border radius) and a starter set of core UI components: Button, Input, Card, Modal, and Badge. Organize all components under src/components/, export them from src/index.ts, and write clear usage rules and installation notes in system.md.
Words decoded
- Design tokens
- Standardized values for colors, font sizes, spacing, and borders used consistently across an entire product.
- Component library
- A collection of pre-made, reusable user interface elements like buttons, input fields, modals, and cards.
- npm package
- A pre-packaged bundle of reusable code shared through the standard JavaScript ecosystem registry.
- Barrel file
- A central file (usually index.ts) that exports all components from one place so other files can import them cleanly.
Where people get stuck
- Do not edit files inside src/design-system/ in your app, because any local edits will be overwritten the next time you accept an update from the design system.
- You cannot attach a draft design system to an app; you must click Release version in the design system project first.
- A project can only connect to one design system at a time; you must remove the active one in Project settings before attaching a different one.
- Design systems only work natively with React; frameworks like Vue, Angular, or Svelte are not supported.
- If you wrap an external npm package (Enterprise plans only), the package must include TypeScript type definitions or the release will fail.
The short version, steps, decoder and prompt on this page are written automatically from Lovable's own documentation and can lag or misread it. The official page is always the authority.