create-tailyew-app

✨ TailYew

A zero-config CLI to scaffold and bootstrap a production-ready TailYew frontend SPA.

🚀 Instantly spin up a modern Yew + TailwindCSS app!

Pure Rust & WASM in production — no JS needed to run your UI.

Note: Tailwind’s CLI (via npm) is still required for development builds.

Dreaming of a totally Rust-native toolchain? Us too! We’re open to ideas and contributions.

✨ What is this?

create-tailyew-app is the official scaffolding tool for the TailYew component system. It sets up a best-practices Yew + Tailwind starter so you can focus on features, not configuration.

You get:

• A ready-to-go Yew/WASM frontend with TailwindCSS (JIT mode)
• Live-reload via cargo-watch
• Dark mode + accessibility baked in
• Examples of atomic, composable UI via TailYew
• Smart Makefile for build, lint, and dev workflows
• Small bundle sizes and no JS dependencies (besides Tailwind tooling)
• See live TailYew demos »

🛠️ Installation

cargo install create-tailyew-app

Requires Rust 1.65+ and npm in your PATH.

🚀 Quick Start

create-tailyew-app <NAME> [--dest <BASE_DIR>]

• NAME — Your new project folder (required)
• --dest — (Optional) Output directory (default: .)

Example

create-tailyew-app my-app
cd my-app
make run-frontend

This launches your dev server at http://localhost:8080.

📁 What’s Generated

<BASE_DIR>/<NAME>/
├─ frontend/
│  ├─ Cargo.toml           # Yew/WASM crate
│  ├─ tailwind.config.js   # TailwindCSS setup (pre-configured for TailYew)
│  ├─ src/                 # Rust app sources
│  ├─ static/              # HTML, safelist, assets, WASM pkg
│  └─ Makefile             # Frontend build & serve tasks
├─ Makefile                # Root orchestrator (run-frontend, lint, format, etc)
└─ README.md               # This file

• Tailwind Safelist: static/tailyew-safelist.html is included for correct dark-mode & dynamic class extraction.
• Live Reload: Hot-reloading for rapid dev (edit, save, reload).

⚡ Powered by TailYew

• 🌗 Dark mode ready with Tailwind’s dark: utilities
• 🧹 50+ components: Buttons, Inputs, Tables, Modals, Charts, Accordions, and more
• 📙 Markdown auto-renders to beautiful, theme-aware TailYew elements
• 📊 Charts (Bar, Line, Bubble, Pie, Scatter) — no JS required
• 📝 Composable Forms — with validation and accessibility
• 🦠 Pure Rust — no JS/TS needed for your UI
• 📦 Tiny WASM builds — thanks to Tailwind JIT and no-runtime bloat
• 📝 A11y: ARIA, labeling, and more

Explore live components: tailyew.com/demo/getting_started

🎬 Dev server

cd <BASE_DIR>/<NAME>
make run-frontend

• Watches Rust sources (frontend/src)
• Rebuilds WASM + auto-reloads browser
• Serves locally at localhost:8080

🔧 Useful Makefile Targets

From your project root:

• make format — Format Rust sources

• make lint — Lint with Clippy

• make pretty — Format + Lint

• make fe-build — Build the Yew/WASM frontend

• make fe-check — Check frontend with Cargo

• make fe-run — Serve with hot-reload (used by run-frontend)

❤️ Contributing

We love contributions! Help grow the Rust UI ecosystem:

1. Fork & clone this repo

2. Edit starter/app/ to change the template

3. Tweak CLI in src/

4. Run make pretty to format & lint

5. Open a PR — all feedback welcome!

📚 Helpful Links

• TailYew Docs & Demos
• Open a Pull Request
• Report a Bug
• Propose a Feature

🔗 Related Projects

• 🦠 Yew Framework
• 🎨 TailwindCSS
• 🚀 TailYew Starter

📜 License

MIT License — see LICENSE