buridan

A command line interface (CLI) for adding components and themes to your project.

Install

uv add gtm-ui-native
# or
pip install gtm-ui-native

The package on PyPI is gtm-ui-native; the command it installs is buridan.

Package naming

This fork publishes gtm-ui-native from elviskahoro/native. Upstream LineIndent/native publishes buridan, and LineIndent/ui publishes buridan-create. All three install a buridan command, so install only one per environment.

create

Opens the Buridan Native theme builder in your browser. Use it to customize your design system and generate a unique preset ID.

buridan create

init

Initialize Buridan Native in your project. This command sets up CSS utilities (shimmer, scroll fade) in assets/globals.css and updates rxconfig.py with the required Tailwind configuration.

buridan init

apply

Apply a theme preset to your project. Generates :root and .dark CSS variable blocks in assets/globals.css based on the preset ID from the theme builder.

buridan apply --preset <ID>

Arguments:

• --preset: The theme preset ID from the Buridan Native theme builder. Use b0 for the default theme.

Example:

buridan apply --preset b0
buridan apply --preset b1000

add

Add components and their dependencies to your project.

buridan add <name>

You can add multiple components at once:

buridan add button input select

Blocks (charts, dashboards, etc.) can be added the same way:

buridan add line_chart_01

Components are placed in components/, blocks in blocks/. Dependencies are resolved and added automatically.

Note: Components require a theme to render correctly. Run buridan apply before using components.

list

Display all available components and blocks.

buridan list

Recommended workflow

buridan create                    # build your theme, copy the preset ID
buridan init                      # set up utilities and Tailwind config
buridan apply --preset <ID>       # apply your theme
buridan add button input select   # add the components you need

Documentation

Visit https://native.buridan.dev/components to see all the components.

Visit https://native.buridan.dev/docs/getting-started/cli section to get started.

License

Licensed under the MIT license