PHPackages rmirandasv/atom-starter-kit - 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. rmirandasv/atom-starter-kit ActiveProject[Framework](/categories/framework) rmirandasv/atom-starter-kit =========================== Laravel Starter Kit with Inertia.js, Typescript, Ract and Shadcn. v1.3.2(9mo ago)12MITTypeScriptPHP ^8.2CI passing Since Jul 14Pushed 9mo agoCompare [ Source](https://github.com/rmirandasv/atom-starter-kit)[ Packagist](https://packagist.org/packages/rmirandasv/atom-starter-kit)[ RSS](/packages/rmirandasv-atom-starter-kit/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (6)Dependencies (12)Versions (7)Used By (0) Atom Starter Kit ================ [](#atom-starter-kit) **Atom Starter Kit** is a modern, highly customizable starter kit that combines the power of **Laravel 12**, **Inertia.js**, **React**, **TypeScript**, **Tailwind CSS 4**, and **Shadcn UI** to help you kickstart your next project with best practices and essential features out of the box. [![image](https://private-user-images.githubusercontent.com/8462799/466818430-70dd8161-43c1-4588-a8a9-505d6300e632.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzUxODU4NjUsIm5iZiI6MTc3NTE4NTU2NSwicGF0aCI6Ii84NDYyNzk5LzQ2NjgxODQzMC03MGRkODE2MS00M2MxLTQ1ODgtYThhOS01MDVkNjMwMGU2MzIucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDQwMyUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA0MDNUMDMwNjA1WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9YjFhNjhjNDk2N2Q5MGFkYzYwMzNkMWZkZjQ5MjUwNjdiZjcyZTMxNzg5NTQ0M2Y0ZDNkNTc0MTJjYmZhNjAwNiZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QifQ.cs5RoNONetUgGuwMMLicbqMgSawfjPQmZ_ejo9U042I)](https://private-user-images.githubusercontent.com/8462799/466818430-70dd8161-43c1-4588-a8a9-505d6300e632.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzUxODU4NjUsIm5iZiI6MTc3NTE4NTU2NSwicGF0aCI6Ii84NDYyNzk5LzQ2NjgxODQzMC03MGRkODE2MS00M2MxLTQ1ODgtYThhOS01MDVkNjMwMGU2MzIucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDQwMyUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA0MDNUMDMwNjA1WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9YjFhNjhjNDk2N2Q5MGFkYzYwMzNkMWZkZjQ5MjUwNjdiZjcyZTMxNzg5NTQ0M2Y0ZDNkNTc0MTJjYmZhNjAwNiZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QifQ.cs5RoNONetUgGuwMMLicbqMgSawfjPQmZ_ejo9U042I)⚡️ Key Features --------------- [](#️-key-features) ### 🔐 Authentication & Security [](#-authentication--security) - User registration and login - Password reset via email - Email verification - **Two-factor authentication (2FA)** with QR codes and recovery codes - Light, dark, and system theme support ### 👤 User Settings [](#-user-settings) - Update profile information - Change password - **Two-factor authentication management** ### 🔒 Protected Routes [](#-protected-routes) - Dashboard - Settings pages 🎨 Easy Customization -------------------- [](#-easy-customization) ### CSS Variables System [](#css-variables-system) The starter kit is built with **Tailwind CSS 4** and uses a comprehensive CSS variables system in `resources/css/app.css`. All components automatically adapt to your custom theme by simply modifying the CSS variables. **Key customization points:** - **Colors**: Primary, secondary, accent, destructive, and chart colors - **Sidebar**: Dedicated sidebar theming variables - **Border radius**: Consistent border radius system - **Dark mode**: Complete dark theme support ### Visual Theme Editor [](#visual-theme-editor) I recommend using **[TweakCN Theme Editor](https://tweakcn.com/editor/theme)** for easy visual customization: 1. Visit the theme editor to customize your design visually 2. Export the generated CSS variables 3. Replace the variables in `resources/css/app.css` 4. All components will automatically update to match your new theme ### Component System [](#component-system) All UI components in `resources/ts/components/ui/` are built with Shadcn UI and are fully customizable. They automatically inherit your CSS variables, so theme changes are applied consistently across the entire application. 🛠️ Development Tools & Testing ---------------------------------- [](#️-development-tools--testing) ### Testing [](#testing) - **Pest PHP** - Configured for writing expressive tests - **Example tests** - Ready-to-use test examples for both Feature and Unit tests ### Code Quality & Standards [](#code-quality--standards) - **ESLint** - JavaScript/TypeScript linting with React rules - **Prettier** - Code formatting with Tailwind CSS plugin - **PHP CS Fixer (Pint)** - PHP code formatting - **TypeScript** - Static type checking ### Git Hooks & Automation [](#git-hooks--automation) - **Husky** - Git hooks for pre-commit validation - **Commitlint** - Conventional commit message validation - **Semantic Release** - Automated versioning and changelog generation ### CI/CD Pipeline [](#cicd-pipeline) - **GitHub Actions** - Automated testing and deployment - `ci.yml` - Runs linting, formatting, and tests - `release.yml` - Automated releases with semantic versioning - **Automatic validation** - Frontend and backend code quality checks - **Changelog management** - Automatic CHANGELOG.md updates 🚀 Quick Start ------------- [](#-quick-start) ### Create a New Project [](#create-a-new-project) ``` laravel new example-app --using=rmirandasv/atom-starter-kit ``` ### For New Applications [](#for-new-applications) We recommend cleaning the `CHANGELOG.md` file when starting a new project to remove the starter kit's history. 🧰 Tech Stack ------------ [](#-tech-stack) - **Laravel 12** – Backend framework - **Inertia.js** – SPA bridge for Laravel + React - **React** – Frontend library - **TypeScript** – Typed JavaScript - **Tailwind CSS 4** – Utility-first CSS framework with CSS variables - **Shadcn UI** – Accessible and composable UI components 🚀 Why Atom Starter Kit? ----------------------- [](#-why-atom-starter-kit) Atom Starter Kit is built for **speed, productivity, and customization**. Whether you're building a SaaS, dashboard, internal tool, or any Laravel-based app with React, this template provides a rock-solid starting point with: - **Ready-to-customize theme system** - Change colors, fonts, and styling with CSS variables - **Production-ready authentication** - Including robust two-factor authentication - **Modern development experience** - TypeScript, hot reloading, and best practices - **Accessible components** - Built with Shadcn UI for better UX - **Dark mode support** - Out of the box with automatic theme switching - **Complete testing setup** - Pest PHP configured with example tests - **Code quality tools** - ESLint, Prettier, and automated CI/CD pipeline - **Automated releases** - Semantic versioning and changelog management Focus on your business logic instead of boilerplate! ### Health Score 32 — LowBetter than 72% of packages Maintenance55 Moderate activity, may be stable Popularity4 Limited adoption so far Community8 Small or concentrated contributor base Maturity53 Maturing project, gaining track record Bus Factor1 Top contributor holds 86.4% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 6 Last Release 299d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/fa32a6def84a92f04edba2d37ebf371531f08ea8bfc1da7085b41bac2c2c1f19?d=identicon)[rmirandasv](/maintainers/rmirandasv) --- Top Contributors [![rmirandasv](https://avatars.githubusercontent.com/u/8462799?v=4)](https://github.com/rmirandasv "rmirandasv (38 commits)")[![semantic-release-bot](https://avatars.githubusercontent.com/u/32174276?v=4)](https://github.com/semantic-release-bot "semantic-release-bot (6 commits)") --- Tags laraveltypescriptinertiareactstarter-kitshadcn ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/rmirandasv-atom-starter-kit/health.svg) ``` [![Health](https://phpackages.com/badges/rmirandasv-atom-starter-kit/health.svg)](https://phpackages.com/packages/rmirandasv-atom-starter-kit) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)