README

Fission Logo

Important

This is an opinionated starter kit created by me (Josh Cirre) using Laravel Livewire and Livewire Flux. While PRs are welcome, this is designed to fit the needs of one person.

Tip

Clone the repository and run composer setup to get started quickly. See Installation below.

TweakFlux — Deep Theming for Flux UI

Fission pairs well with TweakFlux, a theming package that lets you transform every Flux component with a single command. Override Tailwind v4 CSS custom properties to apply 20+ preset themes or generate your own — zero vendor files touched.

composer global require joshcirre/tweakflux
tweakflux apply bubblegum

Why Does This Exist?

Up until Livewire Flux released, I used Breeze as a starting point for 99% of new projects that I would create. Typically, those new projects were built for demos on videos or starting points for tutorials. In addition, I would start side projects or app ideas with Breeze, as well.

Eventually I knew I wanted to create my own starting kit that worked well for what I needed in most scenarios. Authentication and a dashboard where I can start writing code.

Once Livewire Flux released, it was the perfect time to make this happen.

Flux License Required

A license for Flux (technically, "Flux Pro") is required to use Fission. Fission does not contain any of Flux's CSS, built CSS, or Blade components. However, if you do not have a license there are only two components used in the Flux Pro version (Toast and Card). Feel free to remove them from the starter kit.

Installation

Quick Start (Recommended)

git clone https://github.com/joshcirre/fission.git my-project
cd my-project
composer setup

Using Composer Create-Project

composer create-project joshcirre/fission my-project
cd my-project
composer setup

Note

The laravel new --using flag is not recommended due to archive extraction issues with special characters in filenames.

The composer setup command handles:

Dependency installation
Environment configuration (.env)
Application key generation
SQLite database creation
Flux Pro credential setup
Database migrations
Project name configuration
NPM dependency installation
Asset building

Development

composer dev          # Start server, queue, logs, and Vite

Code Quality

Fission enforces strict code quality through automated tooling:

composer fix          # Fix everything: types, refactoring, formatting
composer test         # Run all checks: tests, linting, types, refactoring

Command	Purpose
`composer fix`	PHPStan → Rector → Prettier → Pint
`composer test`	Typos → Pest → Lint check → PHPStan → Rector dry-run
`composer lint`	Pint + Prettier (quick format)
`composer refactor`	Rector only

Individual Test Commands

composer test:unit          # Pest tests (parallel)
composer test:unit:coverage # Pest with coverage
composer test:types         # PHPStan analysis
composer test:lint          # Check formatting (no fix)
composer test:refactor      # Rector dry-run
composer test:typos         # Peck typo checker

Tooling Stack

Pest - Testing framework
PHPStan + Larastan - Static analysis (max level)
Rector - Automated refactoring
Pint - PHP code style (strict Laravel)
Prettier - JS/CSS formatting
Peck - Typo detection

Recommended AI Skills

If you use AI coding assistants with this project, these skills provide useful context for the stack:

Skill	Install
Flux UI Development — Flux UI component usage, variants, and patterns	`npx skills add laravel/boost --skill fluxui-development`
Livewire Development — Livewire 4 component patterns, directives, islands, and testing	`npx skills add spatie/freek.dev@livewire-development`
TweakFlux Theme Generator — Generate custom Flux UI themes from descriptions or palettes	`tweakflux boost` (requires joshcirre/tweakflux)

License

The Fission starter kit is open-sourced software licensed under the MIT license.

joshcirre / fission

Maintainers

Details