Skip to main content
AdonisJS Starter Kit is a production-ready template that combines the power of AdonisJS with modern frontend tools to help you build scalable applications faster.

​
What is AdonisJS Starter Kit?

AdonisJS Starter Kit is a comprehensive, monorepo-based template designed to streamline the development of full-stack applications. Built on top of AdonisJS, it integrates industry-standard tools and best practices to help you focus on building features rather than configuring infrastructure. The starter kit leverages modern technologies including TurboRepo for efficient monorepo management, pnpm for fast package management, Inertia.js for seamless SPA integration, ShadCN for beautiful UI components, Tailwind CSS for rapid styling, and PostgreSQL for robust data storage.

​
Key Features

Monorepo Architecture

Efficient package management and build processes powered by TurboRepo and pnpm

Modern UI Components

Reusable and customizable components provided by ShadCN with Tailwind CSS

Full-Stack Integration

Seamless SPA experience with Inertia.js connecting React to AdonisJS

Authentication & Authorization

Complete user management with social auth, password recovery, and role-based access

Internationalization

Built-in i18n support with English and Portuguese translations

Developer Experience

Hot module reloading, TypeScript support, and modular architecture

​
Core Capabilities

​
Monorepo Setup

The starter kit uses TurboRepo and pnpm to manage a monorepo structure that separates concerns while enabling code sharing: 
root/
├── apps/
│   └── web/        # Full-stack AdonisJS application with Inertia.js
├── packages/
│   ├── ui/         # Shared UI components library
│   ├── eslint-config/
│   └── typescript-config/
├── pnpm-workspace.yaml
└── turbo.json
This architecture allows you to scale your application by adding new apps or extracting shared logic into reusable packages.

​
UI Framework

Built on ShadCN and Tailwind CSS, the starter kit provides a comprehensive collection of accessible, customizable UI components. The @workspace/ui package contains shared components that can be used across all applications.

​
Frontend Integration

Inertia.js bridges the gap between your AdonisJS backend and React frontend, providing:
  • Server-side routing with client-side rendering
  • Automatic page component loading
  • Shared data between backend and frontend
  • Type-safe API calls with Tuyau

​
Authentication

Comprehensive authentication and authorization system featuring:
  • User Management: Complete CRUD operations for user accounts
  • Social Authentication: Integration with Google, GitHub, and other providers via @adonisjs/ally
  • Password Recovery: Built-in password reset functionality
  • User Impersonation: Admin capability to assume user identities for support
  • API Tokens: Personal access token generation for API authentication
  • Role-Based Access: Fine-grained permissions using @adonisjs/bouncer and CASL

​
Database & Storage

  • PostgreSQL: Robust relational database with Lucid ORM
  • Migrations: Version-controlled database schema changes
  • Seeders: Populate your database with initial data
  • File Attachments: Handle file uploads with @jrmc/adonis-attachment

​
i18n Support

Built-in internationalization powered by @adonisjs/i18n and react-i18next:
  • Default support for English and Portuguese
  • Easy to add additional languages
  • ICU message format support
  • Automatic language detection

​
Developer Tools

The starter kit includes essential development tools:
  • Mailpit: Local email testing interface (port 8025)
  • PgAdmin: PostgreSQL database administration (port 5050)
  • Docker Compose: Containerized development environment
  • Hot Module Reloading: Instant feedback during development
  • TypeScript: Type safety across frontend and backend

​
Appearance Customization

Users can personalize their experience with comprehensive appearance settings:
  • Theme: Light and Dark mode support
  • Layout: Choose between Sidebar and Header layouts
  • Sidebar Variants: Multiple sidebar style options
  • Direction: LTR and RTL support for international audiences
  • Local Persistence: Settings saved to browser storage

​
Modular Architecture

The starter kit supports feature-based modules using @adonisjs-community/modules, allowing you to organize your application into self-contained feature directories: 
app/
└── users/
    ├── controllers/
    ├── models/
    ├── services/
    ├── validators/
    ├── database/
    └── routes.ts
Each module can have its own routes, database migrations, and resources, making your codebase easier to scale and maintain.

​
Technology Stack

AdonisJS

Full-featured Node.js framework

React

Component-based UI library

TypeScript

Type-safe JavaScript

PostgreSQL

Relational database

Tailwind CSS

Utility-first CSS framework

TurboRepo

High-performance monorepo

​
What’s Next?

Quick Start

Get up and running in minutes with our quickstart guide

Installation

Detailed installation instructions and prerequisites
The AdonisJS Starter Kit is open source and actively maintained. Contributions are welcome!

Build docs developers (and LLMs) love

Get started for freeTalk to us