AdonisJS Starter Kits

Official starter kits for building production-ready applications with AdonisJS.

Choose the right foundation for your next project based on your preferred frontend approach.

Starter Kits   •   Quick Start   •   Documentation

---

📦 Available Starter Kits

This repository contains the official AdonisJS starter kits, each tailored for different frontend approaches and use cases.

Starter Kit	Description	Best For
API	Type-safe REST API with dual authentication (tokens & sessions)	Building APIs for any frontend, mobile apps, third-party integrations
Hypermedia	Server-rendered applications with Edge.js templates and Alpine.js	Traditional web apps, admin panels, content sites
Inertia React	Single-page applications with React and Inertia.js	Modern SPAs with React ecosystem
Inertia Vue	Single-page applications with Vue and Inertia.js	Modern SPAs with Vue ecosystem

---

🚀 Quick Start

API Starter Kit

Build type-safe REST APIs with dual authentication (API tokens and sessions) that work with any frontend framework.

npm init adonisjs@latest -- -K=api

Includes: Tuyau (type-safe API calls), Dual authentication (API tokens + sessions), Lucid ORM, RESTful structure

Learn more about API →

---

Hypermedia Starter Kit

Build server-rendered applications with Edge.js templating and progressive enhancement using Alpine.js.

npm init adonisjs@latest -- -K=hypermedia

Includes: Edge.js templating, Alpine.js, Custom CSS design system, Session authentication

Learn more about Hypermedia →

---

Inertia React Starter Kit

Build modern single-page applications with React while keeping the simplicity of server-side routing.

npm init adonisjs@latest -- -K=inertia

During setup, select react as your frontend adapter.

Includes: React 19, Inertia.js, Tuyau (type-safe routing), Sonner (toast notifications)

Learn more about Inertia React →

---

Inertia Vue Starter Kit

Build modern single-page applications with Vue while keeping the simplicity of server-side routing.

npm init adonisjs@latest -- -K=inertia

During setup, select vue as your frontend adapter.

Includes: Vue 3, Inertia.js, Tuyau (type-safe routing), Vue Sonner (toast notifications)

Learn more about Inertia Vue →

---

🎯 Choosing a Starter Kit

Choose API if you want:

• Build a backend API for any frontend framework (React, Vue, Svelte, Angular, etc.)
• Develop mobile apps or third-party integrations
• Type-safe API calls between frontend and backend with Tuyau
• Flexible authentication (API tokens for cross-origin, sessions for same-domain)
• Framework-agnostic API-first architecture

Choose Hypermedia if you want:

• Fast initial page loads with server-side rendering
• SEO-friendly pages that work without JavaScript
• Progressive enhancement with minimal client-side JavaScript
• Traditional multi-page application architecture

Choose Inertia React if you want:

• Rich client-side interactivity with React
• SPA-like navigation without the API complexity
• Access to the React ecosystem (hooks, libraries, components)
• End-to-end type safety with Tuyau

Choose Inertia Vue if you want:

• Rich client-side interactivity with Vue
• SPA-like navigation without the API complexity
• Access to the Vue ecosystem (Composition API, libraries, components)
• End-to-end type safety with Tuyau

---

🔧 Common Features

All starter kits include:

• Authentication System - User signup, login, and session management
• Database Integration - Lucid ORM with migrations (SQLite, PostgreSQL, MySQL, MSSQL)
• Form Validation - VineJS with automatic error handling
• Security - CSRF protection, Shield middleware, secure sessions
• TypeScript - Full TypeScript support with strict mode
• Testing - Japa testing framework with browser testing support
• Vite - Lightning-fast HMR and optimized production builds

---

📚 Learn More

📖 Documentation Complete guide to AdonisJS	💾 Lucid ORM Database queries and relationships
🎨 Edge.js Templating engine documentation	✅ VineJS Schema validation guide

---

🤝 Contributing

Found a bug or have a suggestion? Open an issue or submit a pull request!

---

📄 License

All starter kits are open-sourced software licensed under the MIT license.

---

_{Built with ❤️ by the AdonisJS team}