chaoswebdev/laravel-kit

My skeleton application for the Laravel framework. Includes SCSS stylings (basic) and Livewire.

v1.5.0 2025-06-24 20:57 UTC

Requires

• php: ^8.2
• laravel/framework: ^12.0
• laravel/tinker: ^2.10.1
• livewire/livewire: ^3.6

Requires (Dev)

• fakerphp/faker: ^1.23
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.6
• phpunit/phpunit: ^11.5.3

MIT

• framework
• laravel

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 (customized Bootstrap-style classes)
• ✅ Livewire views organized under resources/views
• ✅ Modular SCSS structure with components/, layout/, themes/, utilities/, views/
• ✅ User migration separated into its own clean file
• ✅ Added APP_TIMEZONE back to .env and configs/app.php. Defaults to America/Denver
• ✅ Commented out migrations for sessions and cache
• ✅ Set sessions and cache to file instead of database
• ✅ Uses cwd-scss from npm for static stylings
• ✅ User model has email and username built in to it

🚀 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/ → SCSS split by layout, components, themes, utilities
• resources/views/ → Updated default Livewire structure
• 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}

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

🔧 Roadmap / Ideas

• Add additional basic Livewire components
• Add additional basic Laravel components
  • Added form components
  • Added link component that supports NerdFonts i.nf

📎 Repo

GitHub: ChaosWebDev/cwd-laravel-kit