v2.4.0

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.

â„šī¸ Prerequisites

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:

Terminal
npm install @webui/core

For TypeScript projects, types are included out of the box:

TypeScript
import { Card, Button, Grid } from '@webui/core';
import type { ThemeConfig } from '@webui/types';

Quick Start

Create a new Webui project with the CLI scaffold:

Terminal
npx create-webui-app my-app
# or
pnpm create webui-app my-app

Once installed, initialize your first component:

JavaScript
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.

webui.config.js
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
âš ī¸ Important

Changes to webui.config.js require restarting the dev server. Hot module reloading is not supported for config changes.

Next Steps

🚀 Ready to ship?

Run webui build to generate optimized production assets. Deploy to Vercel, Netlify, or any static host in seconds.