AdonisJS + React Full-Stack Starter Kit

Introduction

A modern, production-ready full-stack web application starter kit built with the latest technologies for those who want to ship fast and ship great.

Designed for developers who value both speed and quality, this template provides a complete foundation for full-stack applications. From solo projects to team collaborations, it scales with your ambitions while maintaining the developer experience you deserve.

Quick Start

1. Create Your Project

Generate a new repository from this template, then clone it locally:

git  clone  https://github.com/YOUR_USERNAME/YOUR_PROJECT_NAME.git

cd  YOUR_PROJECT_NAME

2. Install Dependencies

pnpm  install | yarn install | npm install

3. Environment Setup

1. Create Environment File

cp  .env.example  .env

2. Generate Application Key

node  ace  generate:key

4. Database Setup

1. Run Migrations

ace  migration:run

5. Start Development

Open a terminal and run the following command:

pn dev

Visit localhost:3333 and both your frontend and backend will be running together.

Technology Stack

Frontend & UI

• React 19 - Latest React with concurrent features

• TypeScript - Static type checking

• Tailwind CSS 4 - Utility-first CSS framework

• ShadCN UI - Beautiful, accessible components

• Vite - Fast build tool and dev server

• Inertia.js - Modern monolithic approach

Backend & API

• AdonisJS - Node.js framework with TypeScript-first approach

• PostgreSQL - Robust relational database

• Session-based Authentication - Secure user authentication

Development Tools

• pnpm - Fast, disk space efficient package manager

• Monorepo - Single repository for frontend and backend

• TypeScript - Full type safety across the stack

• ESLint & Prettier - Code quality and formatting

Prerequisites

• Node.js 18+

• PostgreSQL 12+

• pnpm 8+ (can be swapped with npm or yarn)