README

A minimal, modern Laravel v12.* starter kit built for rapid development with clean defaults, Livewire v3, and SCSS-based styling utilities.

📦 Features

• ✅ Laravel 12.*
• ✅ Livewire v3
• ✅ SCSS-ready via Vite (npm i -D sass)
• ✅ Utility-based SCSS (Bootstrap-inspired utility classes)
• ✅ Livewire views organized under resources/views
• ✅ User migration separated into its own clean file
• ✅ Added APP_TIMEZONE back to .env and configs/app.php. Defaults to America/Denver
• ✅ User model has email and username built in to it
• ✅ Ability to use MongoDB

🚀 Installation

composer create-project chaoswebdev/laravel-kit my-project-name > cd my-project-name > php kit

Clone manually:

git clone https://github.com/ChaosWebDev/cwd-laravel-kit.git your-project-name
cd your-project-name
rm -rf .git # or ri .git -r -force for windows
composer install
npm install && npm run dev
cp .env.example .env
php artisan key:generate

📁 Directory Highlights

• resources/styles/ → Built to contain view stylings as partials to be forwarded in app.scss
• resources/views/components/layouts/app.blade.php → Updated default Livewire layout location
• database/migrations/ → users table isolated in its own migration

Git

You can commit, version tag, and push using the kit-commit file in the root directory.

php kit-commit -n="Notes Here" -v="0.0.0" The file will then run:

git add .
git commit -m $notes
git tag v{$version} -m "Release v{$version}"
git push
git push origin v{$version}

-n and -v are optional. If -v is omitted, the file will attempt to find the next version and parse it in for you.

Example

If you do php kit-commit -n="See Changelog for v0.0.1" -v="0.0.1" The system will run:

git add .
git commit -m "See Changelog for v0.0.1"
git tag v0.0.1 -m "Release v0.0.1"
git push
git push origin v0.0.1

📎 Repo

GitHub: ChaosWebDev/cwd-laravel-kit

Related Project Documentation

• Laravel
• Livewire
• NativePHP
• Laravel MongoDB