PHPackages aronpc/react-starter-kit-auth - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Framework](/categories/framework) 4. / 5. aronpc/react-starter-kit-auth ActiveProject[Framework](/categories/framework) aronpc/react-starter-kit-auth ============================= Laravel starter kit with opinionated modern tooling setup. v1.2.0(7mo ago)14MITPHPPHP ^8.4CI passing Since Oct 7Pushed 7mo agoCompare [ Source](https://github.com/aronpc/react-starter-kit-auth)[ Packagist](https://packagist.org/packages/aronpc/react-starter-kit-auth)[ RSS](/packages/aronpc-react-starter-kit-auth/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (3)Dependencies (21)Versions (4)Used By (0) React Starter Kit with Auth =========================== [](#react-starter-kit-with-auth) [![Build Status](https://github.com/aronpc/react-starter-kit-auth/actions/workflows/tests.yml/badge.svg)](https://github.com/aronpc/react-starter-kit-auth/actions) [![License](https://camo.githubusercontent.com/85798056f1a178262d56be539027c248947966a01d15732bb023452e2f516460/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f61726f6e70632f72656163742d737461727465722d6b69742d61757468)](https://github.com/aronpc/react-starter-kit-auth/blob/main/LICENSE.md) [![GitHub Stars](https://camo.githubusercontent.com/446bb73acbfdaa83f3b10d41b880bc0a8284ee5f26afc9df3b313849115b0d23/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f61726f6e70632f72656163742d737461727465722d6b69742d61757468)](https://github.com/aronpc/react-starter-kit-auth) 📋 Overview ---------- [](#-overview) A modern, production-ready Laravel starter kit featuring React 19, TypeScript, and Inertia.js with full authentication system. This starter kit provides opinionated modern tooling setup with best practices for rapid application development. 🛠️ Tech Stack ------------- [](#️-tech-stack) ### Backend [](#backend) - **Laravel 12**: Latest Laravel framework with PHP 8.4+ - **Inertia.js**: Modern monolith architecture connecting Laravel with React - **Laravel Fortify**: Headless authentication backend - **Laravel Wayfinder**: Type-safe routing for frontend - **SQLite**: Default database (configurable to MySQL/PostgreSQL) - **Queue & Cache**: Database-backed (configurable to Redis) ### Frontend [](#frontend) - **React 19**: Latest React with modern hooks and concurrent features - **TypeScript 5.7**: Full type safety across the frontend - **Vite 7**: Lightning-fast build tool and dev server - **Tailwind CSS 4.0**: Utility-first CSS framework - **Radix UI**: Accessible, unstyled UI components - **Lucide Icons**: Beautiful icon library - **Inertia.js React**: Seamless SPA experience with SSR support ### Code Quality & Testing [](#code-quality--testing) - **Pest**: Modern PHP testing framework - **PHPStan/Larastan**: Static analysis for Laravel - **Rector**: Automated code refactoring and upgrades - **Pint**: Opinionated PHP code formatter - **ESLint**: JavaScript/TypeScript linting - **Prettier**: Code formatting for frontend - **Architecture Tests**: Enforce code quality and conventions ### Development Tools [](#development-tools) - **Laravel Boost**: MCP server for AI assistant integration - **Laravel Pail**: Real-time log viewer - **Laravel Sail**: Docker development environment - **Laravel IDE Helper**: Enhanced IDE autocompletion - **Concurrently**: Run multiple dev servers simultaneously 📋 Requirements -------------- [](#-requirements) - **PHP 8.4+** with required extensions (see `composer.json`) - **Node.js 18+** and npm (for frontend assets) - **Composer 2+** for PHP dependency management - **Database**: SQLite (default), MySQL 8+, or PostgreSQL 13+ 🚀 Quick Start ------------- [](#-quick-start) ### Using Laravel Installer (Recommended) [](#using-laravel-installer-recommended) ``` # Create a new project using Laravel installer laravel new my-project --using=aronpc/react-starter-kit-auth # Start development servers composer run dev ``` ### Using Git Clone [](#using-git-clone) ``` # Clone the repository git clone git@github.com:aronpc/react-starter-kit-auth.git cd react-starter-kit-auth # Install dependencies composer install npm install # Set up environment cp .env.example .env php artisan key:generate # Run migrations php artisan migrate # Start development servers (Laravel, Queue, Logs, Vite) composer run dev ``` 📜 Available Scripts ------------------- [](#-available-scripts) ### Composer Scripts (PHP) [](#composer-scripts-php) ``` # Development composer run dev # Start all dev servers (artisan, queue, pail, vite) composer run dev:ssr # Start dev servers with SSR support # Code Quality composer run fix # Auto-fix code with Rector and Pint composer run refactor # Run Rector code refactoring # Testing composer run test # Run all tests (unit, types, refactor checks) composer run test:unit # Run Pest unit and feature tests composer run test:unit:coverage # Run tests with coverage report composer run test:types # Run PHPStan static analysis composer run test:refactor # Check Rector refactoring suggestions (dry-run) composer run test:lint # Check code style with Pint (no changes) # Direct tool access ./vendor/bin/pint # Format code with Pint ./vendor/bin/phpstan analyse # Run static analysis ./vendor/bin/rector # Run Rector php artisan test # Run Pest tests ``` ### NPM Scripts (Frontend) [](#npm-scripts-frontend) ``` npm run dev # Start Vite dev server with HMR npm run build # Build for production npm run build:ssr # Build for production with SSR # Code Quality npm run lint # Run ESLint with auto-fix npm run format # Format code with Prettier npm run format:check # Check formatting without changes npm run types # Run TypeScript type checking ``` 🌐 Internationalization (i18n) ----------------------------- [](#-internationalization-i18n) This starter kit is built with multi-language support from the ground up: - **Translation System**: Uses Laravel's built-in localization - **Default Locale**: Configured via `APP_LOCALE` environment variable - **Fallback Locale**: English (`en`) - **Structure**: Organized translation files in `lang/{locale}/` ### Usage [](#usage) ``` // In PHP/Blade {{ __('messages.welcome', ['name' => $user->name]) }} // In controllers/models $message = __('messages.success'); // Pluralization {{ trans_choice('messages.items', $count) }} ``` **Translation File Structure:** ``` lang/ ├── en/ │ ├── auth.php # Authentication messages │ ├── validation.php # Validation messages │ └── messages.php # General messages └── pt_BR/ ├── auth.php ├── validation.php └── messages.php ``` **Important**: Never hardcode user-facing text - always use translation keys for proper i18n support. 🔧 Environment Variables ----------------------- [](#-environment-variables) Key environment variables (see `.env.example` for full list): ``` # Application APP_NAME=Laravel # Application name APP_ENV=local # Environment (local, production) APP_KEY= # Generate with: php artisan key:generate APP_URL=http://localhost # Application URL APP_LOCALE=pt_BR # Default locale (pt_BR, en, etc.) # Database DB_CONNECTION=sqlite # Database type (sqlite, mysql, pgsql) # For MySQL/PostgreSQL, configure: DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD # Session & Cache SESSION_DRIVER=database # Session storage (database, redis, file) CACHE_STORE=database # Cache driver (database, redis, file) QUEUE_CONNECTION=database # Queue driver (database, redis, sync) # Mail (for auth emails) MAIL_MAILER=log # Mail driver (log, smtp, mailgun, etc.) MAIL_FROM_ADDRESS="hello@example.com" MAIL_FROM_NAME="${APP_NAME}" # Frontend VITE_APP_NAME="${APP_NAME}" # Exposed to frontend ``` For production deployment, ensure you configure proper database, cache, queue, and mail settings. 📦 Key Packages -------------- [](#-key-packages) ### Backend (PHP) [](#backend-php) - `laravel/framework` - Laravel 12 framework - `inertiajs/inertia-laravel` - Inertia.js server adapter - `laravel/fortify` - Authentication backend - `laravel/wayfinder` - Type-safe routing - `nunomaduro/essentials` - Essential Laravel packages - `archtechx/enums` - Enhanced PHP enums ### Frontend (JavaScript/TypeScript) [](#frontend-javascripttypescript) - `react` & `react-dom` - React 19 - `@inertiajs/react` - Inertia.js React adapter - `typescript` - TypeScript support - `vite` - Build tool and dev server - `tailwindcss` - Utility-first CSS - `@radix-ui/*` - Accessible UI components - `lucide-react` - Icon library ### Development Tools [](#development-tools-1) - `pestphp/pest` - Testing framework - `larastan/larastan` - Static analysis - `rector/rector` - Code refactoring - `laravel/pint` - Code formatter - `laravel/boost` - MCP server for AI - `laravel/sail` - Docker environment - `eslint` & `prettier` - Frontend code quality 📁 Project Structure ------------------- [](#-project-structure) ``` ├── app/ │ ├── Contracts/ # Interfaces and traits (HasEnumFeatures) │ ├── Http/ │ │ ├── Controllers/ # Auth, Settings controllers │ │ ├── Middleware/ # Inertia, Appearance middleware │ │ └── Requests/ # Form request validation │ ├── Models/ # Eloquent models (User) │ └── Providers/ # Service providers (Fortify, App) ├── resources/ │ ├── css/ │ │ └── app.css # Tailwind CSS entry point │ ├── js/ │ │ ├── actions/ # Server actions (App, Illuminate, Laravel) │ │ ├── components/ # React components and UI library │ │ ├── hooks/ # Custom React hooks │ │ ├── layouts/ # Page layouts (app, auth, settings) │ │ ├── pages/ # Inertia pages (auth, dashboard, settings) │ │ ├── routes/ # Wayfinder type-safe routes │ │ ├── types/ # TypeScript definitions │ │ ├── app.tsx # Main React entry point │ │ └── ssr.tsx # SSR entry point │ └── views/ │ └── app.blade.php # Root Blade template for Inertia ├── routes/ │ ├── web.php # Application routes │ ├── auth.php # Authentication routes │ └── console.php # Artisan commands ├── tests/ │ ├── Feature/ # Feature tests │ └── Unit/ # Unit tests ├── database/ │ ├── migrations/ # Database migrations │ └── seeders/ # Database seeders ├── config/ # Laravel configuration files ├── composer.json # PHP dependencies and scripts ├── package.json # Node dependencies and scripts ├── vite.config.ts # Vite build configuration ├── phpunit.xml # PHPUnit/Pest configuration ├── phpstan.neon # PHPStan configuration ├── rector.php # Rector configuration ├── pint.json # Pint configuration ├── tsconfig.json # TypeScript configuration ├── eslint.config.js # ESLint configuration └── boost.json # Laravel Boost MCP configuration ``` ### Entry Points [](#entry-points) **Backend:** - `artisan` - Laravel CLI entry point - `public/index.php` - HTTP entry point **Frontend:** - `resources/js/app.tsx` - Client-side React application - `resources/js/ssr.tsx` - Server-side rendering entry point - `resources/css/app.css` - CSS entry point with Tailwind 🤖 Laravel Boost - MCP Server ---------------------------- [](#-laravel-boost---mcp-server) This starter kit includes [Laravel Boost](https://github.com/laravel/boost), an official Laravel MCP (Model Context Protocol) server that enhances AI assistant capabilities when working with Laravel projects. ### Features [](#features) - **Project Context**: Provides AI assistants with deep understanding of your Laravel project structure - **Code Intelligence**: Enables better code suggestions and refactoring recommendations - **Laravel Expertise**: Offers Laravel-specific knowledge and best practices - **Seamless Integration**: Works automatically with Claude Code and other MCP-compatible AI tools ### Configuration [](#configuration) MCP server is configured in `.mcp.json` and `boost.json`. Laravel Boost is pre-configured and ready to use - no additional setup required. ``` # MCP server runs via: php artisan boost:mcp ``` 🏗️ Architecture Tests --------------------- [](#️-architecture-tests) This starter kit includes comprehensive architecture tests using Pest to enforce code quality and consistency: ### Included Presets [](#included-presets) - **PHP Preset**: Ensures no `var_dump`, `dd()`, or deprecated functions - **Security Preset**: Prevents usage of dangerous functions like `eval()`, `exec()`, `shell_exec()` - **Laravel Preset**: Enforces Laravel best practices and conventions ### Custom Rules [](#custom-rules) - **Enum Validation**: All files in `App\Enums` must be valid enum classes - **HasEnumFeatures Trait**: All enums must use the `HasEnumFeatures` trait for consistency These tests run automatically with your test suite and help maintain code quality standards across the project. ``` # Run only architecture tests php artisan test --filter=ArchTest ``` 🎯 Enhanced Enums ---------------- [](#-enhanced-enums) This starter kit includes the [ArchTech Enums](https://github.com/archtechx/enums) package with a pre-configured `HasEnumFeatures` trait that provides: - **Invokable cases**: Use enums as callables - **Metadata**: Attach arbitrary data to enum cases - **Names & Values**: Easy access to case names and values - **From**: Create enums from various inputs with better error handling - **Comparison**: Rich comparison methods - **Options**: Generate arrays for dropdowns and forms ### Usage [](#usage-1) All enums in `app/Enums` should use the `HasEnumFeatures` trait: ```