Welcome to the official monorepo for the Nova UI Kit, the comprehensive design system and component library for the TUWA ecosystem. This project provides all the necessary tools to build beautiful, consistent, and high-performance Web3 applications.

Our ecosystem is built on a clear separation of concerns:

• Pulsar Engine (pulsar-core, pulsar-evm, pulsar-solana): The headless state management libraries that handle all the Web3 logic.
• Nova UI Kit (this repo): The view layer, providing foundational styles and React components to visualize the state managed by Pulsar.

This repository is managed using pnpm workspaces.

Package	Version	Description
🎨 @tuwaio/nova-core		Foundational package with styling primitives, CSS variables, and helper utilities.
🧩 @tuwaio/nova-transactions		React component library for visualizing transaction states (modals, toasts, etc.).

• Framework: React 19
• Styling: Tailwind CSS v4
• State Management: Zustand (via Pulsar)
• Tooling: TypeScript, pnpm, Vite, Storybook

Follow these steps to set up the development environment on your local machine.

git clone [https://github.com/TuwaIO/nova-uikit.git](https://github.com/TuwaIO/nova-uikit.git)
cd nova-uikit

This project uses pnpm. Make sure you have it installed (npm install -g pnpm). Then run:

pnpm install

After installation, it's a good practice to build all packages to ensure everything is linked correctly.

pnpm build

The primary way to develop and test components is through Storybook.

To start the Storybook development server, run the following command from the root of the repository:

pnpm dev

This will open Storybook at http://localhost:6006.

Contributions are welcome! Please read our main Contribution Guidelines.

If you find this library useful, please consider supporting its development. Every contribution helps!

➡️ View Support Options

This project is licensed under the Apache-2.0 License - see the LICENSE file for details.