README

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

📦 Features/Requirements

✅ PHP v8.4+
✅ Laravel 13.*
✅ Laravel Boost 2.*
✅ Livewire v4.*
✅ SCSS-ready via Vite (npm i -D sass)
✅ SCSS package (via npm) cwdscss
✅ 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

Styling

cwdscss is included by default and can be imported in several ways depending on your needs.

Import everything

@use "cwdscss" as *;

Includes all utilities, classes, and components. This will output CSS.

Core only (no CSS output)

@use "cwdscss/core" as *;

Includes variables, mixins, and themes only. Safe to use globally.

Components

@use "cwdscss/components";

Includes UI components and layout styles. Outputs CSS.

Utility classes

@use "cwdscss/classes";

Includes utility classes such as spacing, flex, and typography. Outputs CSS.

📎 Repo

GitHub: ChaosWebDev/cwd-laravel-kit

chaoswebdev / laravel-kit

Maintainers

Package info

Statistics

Security