Getting Started
Learn how to install and configure Webui in your project. Build production-ready interfaces in minutes.
Overview
Webui is a design-to-code engine that generates clean, semantic, and highly performant UI components. Whether you're prototyping a landing page or building a complex dashboard, Webui streamlines your workflow from design to deployment.
Ensure you have Node.js 18+ and npm/yarn/pnpm installed. Basic knowledge of HTML/CSS and JavaScript is recommended.
Installation
Install the core package using your preferred package manager:
npm install @webui/core
For TypeScript projects, types are included out of the box:
import { Card, Button, Grid } from '@webui/core';
import type { ThemeConfig } from '@webui/types';
Quick Start
Create a new Webui project with the CLI scaffold:
npx create-webui-app my-app
# or
pnpm create webui-app my-app
Once installed, initialize your first component:
const app = await Webui.create({
target: '#app',
theme: 'default',
components: [Card, Button]
});
app.mount();
Configuration
Customize Webui behavior using a configuration file at the root of your project.
export default {
framework: 'react',
output: {
dir: './dist',
minify: true,
sourcemap: false
},
plugins: [
'@webui/plugin-tailwind',
'@webui/plugin-i18n'
]
};
| Option | Type | Default | Description |
|---|---|---|---|
framework |
string | 'vanilla' |
Target framework (react, vue, svelte) |
output.minify |
boolean | true |
Enable production minification |
plugins |
array | [] |
List of enabled Webui plugins |
Changes to webui.config.js require restarting the dev server. Hot module reloading is not supported for config changes.
Next Steps
- Explore the Component Library for pre-built UI primitives
- Read about Theming & Design Tokens to match your brand
- Check the API Reference for advanced customization
Run webui build to generate optimized production assets. Deploy to Vercel, Netlify, or any static host in seconds.