👑 Tiara

A Pure Nim UI Component Library for SSR-first applications.

---

Tiara is a deeply optimized, headless-inspired UI component library built entirely in Nim. It focuses on Server-Side Rendering (SSR) applications and delivers beautiful, accessible, and fast web experiences without shipping overly bloated JavaScript.

✨ Features

• Pure Nim: Write your backend, frontend structures, and logic entirely in Nim.
• SSR-First: Highly optimized for Server-Side Rendering workflows.
• Modern Aesthetics: Sleek, headless, and accessible default designs.
• Zero-Bloat: Only ships what you need. Clean HTML outputs.
• Customizable: Easy to override default styles manually to fit your brand.

📦 Installation

Install via Nimble:

nimble install tiara

Note: The website and examples directories are excluded from the Nimble package; tests is skipped. Markdown guides under docs/ are included so Crown integration notes ship with the library.

🚀 Quick Start

Here is a simple example showing how to render a Toast component using Tiara:

import tiara/components/toast

let myToast = renderToast(
  message = "Action completely successfully!",
  position = "bottom-right",
  duration = 3000
)

echo myToast

📚 Documentation

For complete documentation, guides, and interactive examples, please visit the Tiara Official Website (or refer to the docs/ folder).

Crown + Basolato

If you use Tiara with Crown for page templates, read docs/crown-integration.md for import patterns and the tiaraHtml macro (avoids a name clash with Crown’s html). Upstream improvement tracking: docs/improvement-plan-index.md.

🤝 Contributing

We welcome contributions from the community! Feel free to open issues, submit pull requests, or share your ideas on how to improve Tiara.

📜 License

This project is licensed under the MIT License.