Easy Vite React SPA Starter

A production-capable Vite + React foundation for fast, API-driven single-page applications.

Documentation · Discussions · Issues

“What do we build for, if not to lessen each other’s hardship?”

Important

This repository is currently in the foundation stage. Do not treat it as production-ready until the first stable release.

Best for

• Dashboards and internal tools
• Authenticated client-side products
• Frontends backed by Django or another external API
• Embedded and operational web applications

Not for: SEO-heavy public sites or applications that require significant server-rendered web behavior.

Baseline

• Vite, React, TypeScript, and typed routing
• Feature-oriented application structure
• API, query, form, environment, and error boundaries
• Theme, i18n, testing, and CI foundations
• AI-agent rules, specs, and architecture documentation

Quick start

Preferred:

fonij create my-product

Direct template use:

gh repo create my-product --template FonijBuild/easy-vite-react-spa-starter --private --clone
cd my-product
cp .env.example .env
pnpm install
pnpm dev

Project contract

• .fonij/starter.json describes this foundation to Fonij.
• AGENTS.md defines repository rules for AI coding agents.
• specs/ contains implementation-ready feature specifications.
• docs/ contains architecture and repository-specific guidance.
• Keep quality checks green before merging changes.

Contributing

Read CONTRIBUTING.md before contributing. Security issues must follow SECURITY.md.