How to export
Two ways: Build (recommended) — Right-click any design → Build. Vibely:- Converts the design’s HTML into a React component tree
- Creates a fresh Web App project
- Drops you into the project with a live preview running
bun install && bun dev runs it locally without ever touching Vibely.
What you get
A complete project structured around Atomic Design:| Level | Examples | What it is |
|---|---|---|
| Atom | Button, Badge, Input, Icon | Smallest UI elements |
| Molecule | Card, FormField, SearchBar | Groups of atoms with a purpose |
| Organism | Navbar, HeroSection, Footer | Big sections of a page |
| Template | DashboardLayout, MarketingLayout | Page-level layouts |
| Page | HomePage, DashboardPage | Full pages, wired with data |
Design tokens, not hardcoded values
Every colour, font, and spacing value from your design becomes a CSS custom property inindex.css:
text-primary, bg-surface) — change the token and every component picks up the new value. No hunt-and-replace.
TypeScript out of the box
Every component is fully typed. Props get explicit interfaces:any, no // @ts-ignore. You can pass the project to a strict TypeScript codebase and it’ll fit.
What ships with the project
Everything a normal Vite + React project would have — and everything Vibely’s Web App template ships with:- Vite + React 19 + Tailwind v4 + shadcn/ui primitives
- TanStack Router for navigation between pages (type-safe, file-based)
DESIGN.mdat the project root, documenting the system- A working
bun dev/bun buildsetup
What gets reviewed before code lands
The export pipeline checks for common issues before handing you the project:- Hardcoded hex values (e.g.
bg-[#6366f1]) — flagged and replaced with token classes (bg-primary) - Missing TypeScript interfaces — added for every component
- Broken imports — fixed
- Accessibility regressions — focus states and ARIA preserved from the design
When to export vs. when to keep designing
| Export when… | Stay in Design Mode when… |
|---|---|
| The design feels right and you want it working | You’re still exploring directions |
| You need to wire in data, auth, or payments | You haven’t decided which design to ship |
| You want to ship to a real URL | You’re presenting concepts to stakeholders |
| The next thing you need is code, not pixels | You don’t have a developer (designs can ship as-is too) |
