Skip to content

Inalegwu/Obsidian

Repository files navigation

AdonisJS React Inertia Starter Kit

Obsidan


✨ What's in the Box

This starter kit is designed to help you build production-ready single-page applications with React and Inertia.js. It combines the modern DX of React with the simplicity of traditional server-side routing, giving you the best of both worlds.

🎯 Core Features

  • 🔐 Authentication System - Complete user signup, login, and session management out of the box
  • ⚛️ React 19 - Latest React with modern hooks and concurrent features
  • 🔄 Inertia.js - Build SPAs without the API complexity—server-side routing that feels like client-side
  • 🎨 Custom Design System - Beautiful, accessible components with modern CSS (OKLCH color system)
  • ✅ Form Validation - Powered by VineJS with automatic error handling
  • 🔔 Toast Notifications - Built-in toast system using Sonner
  • 🛡️ Security First - CSRF protection, Shield middleware, and secure session handling
  • 🔒 Type Safety - End-to-end TypeScript with Tuyau for type-safe routing
  • TailwindCSS- Styling preconfigured with a default theme to get you started
  • Radix Primitives - Unstyled components to build your own Design system
  • Solar Icons - Modern Icon Pack with Beautiful Variants

🔧 Tech Stack

Backend AdonisJS 7.x - Full-featured Node.js framework
Frontend React 19 - Modern UI library with hooks and concurrent rendering
Adapter Inertia.js - Build SPAs with server-side routing (no API needed)
Database Lucid ORM - SQL ORM with migrations (SQLite, PostgreSQL, MySQL, MSSQL)
Auth Session-based authentication with secure cookie storage
Styling Custom CSS with modern features (OKLCH colors, CSS variables)
Build Vite - Lightning-fast HMR and optimized builds
Validation VineJS - Type-safe schema validation
Type Safety Tuyau - End-to-end type safety for routes and API calls
UI Components Sonner - Toast notifications for React
Testing Japa - Delightful testing framework with browser testing support
TypeScript Full TypeScript support with strict mode enabled

🎨 Philosophy

This starter kit embraces the modern full-stack approach to web development:

  • Server-Side Routing - No API complexity, just controllers returning Inertia responses
  • Client-Side Experience - React handles the UI with smooth SPA navigation
  • Type Safety Everywhere - TypeScript across frontend and backend with Tuyau integration
  • Convention Over Configuration - Sensible defaults, escape hatches when you need them
  • Developer Experience - Hot reload, great error messages, instant feedback
  • Production Ready - Security, validation, and testing built-in

Why Inertia.js?

Traditional SPAs require building and maintaining a separate API. Inertia.js eliminates this complexity by letting your controllers return data directly to your React components. You get the smooth navigation of a SPA with the simplicity of traditional server-side routing.

📄 License

This starter kit is open-sourced software licensed under the MIT license.


Built with ❤️ by DisgruntledDevs

About

AdonisJS Starter Kit with all packages I use across all my projects pre-configured to get up and running faster

Topics

Resources

Stars

Watchers

Forks

Contributors