PHPackages joshcirre/fission - 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. joshcirre/fission ActiveProject[Framework](/categories/framework) joshcirre/fission ================= An opinionated starter kit for building Laravel applications. v1.2.2(1mo ago)20624426MITPHPPHP ^8.4CI failing Since Nov 12Pushed 1mo ago4 watchersCompare [ Source](https://github.com/joshcirre/fission)[ Packagist](https://packagist.org/packages/joshcirre/fission)[ RSS](/packages/joshcirre-fission/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (40)Versions (31)Used By (0) ![Fission Logo](https://github.com/user-attachments/assets/fd074588-4ffd-47f3-af6e-a24500ecbc55) 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](#installation) below. TweakFlux — Deep Theming for Flux UI ------------------------------------ [](#tweakflux--deep-theming-for-flux-ui) Fission pairs well with [**TweakFlux**](https://github.com/joshcirre/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 ``` [![TweakFlux Bubblegum theme preview](art/tweakflux-preview.jpeg)](art/tweakflux-preview.jpeg) Why Does This Exist? -------------------- [](#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 --------------------- [](#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 ------------ [](#installation) ### Quick Start (Recommended) [](#quick-start-recommended) ``` git clone https://github.com/joshcirre/fission.git my-project cd my-project composer setup ``` ### Using Composer Create-Project [](#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 - Optional teams scaffolding (defaults to no during install) - Database migrations - Project name configuration - NPM dependency installation - Asset building During installation, Fission will ask whether you want full teams support. - Choose `yes` to keep team creation, switching, invitations, and member role management. - Choose `no` to remove the team-specific backend, routes, views, and tests before setup finishes. ### Working With Teams [](#working-with-teams) When teams are enabled, Fission follows the starter-kit pattern for team-aware features: - Store the active team on the user via `current_team_id` and switch context from the team switcher UI. - Put team-owned features under a team URL when the page itself is team-specific, for example `/{team}/playground`. - Model team-owned records with a `team_id` foreign key and query through the bound team, not globally. - Authorize access through team membership or team policies, for example `->can('view', 'team')` on routes. - Keep generic account pages like `/profile` unscoped unless the page is explicitly about a team. Development ----------- [](#development) ``` composer dev # Start server, queue, logs, and Vite ``` ### Code Quality [](#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 ``` CommandPurpose`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 [](#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 [](#tooling-stack) - **[Pest](https://pestphp.com)** - Testing framework - **[PHPStan](https://phpstan.org)** + Larastan - Static analysis (max level) - **[Rector](https://getrector.com)** - Automated refactoring - **[Pint](https://laravel.com/docs/pint)** - PHP code style (strict Laravel) - **[Prettier](https://prettier.io)** - JS/CSS formatting - **[Peck](https://github.com/peckphp/peck)** - Typo detection Recommended AI Skills --------------------- [](#recommended-ai-skills) If you use [AI coding assistants](https://skills.sh) with this project, these skills provide useful context for the stack: SkillInstall**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](https://github.com/joshcirre/tweakflux))**Playwriter** — Control your actual Chrome browser from AI agents (requires [Chrome extension](https://playwriter.dev))Included in `.agents/skills/` · CLI: `npm i -g playwriter`**Expect CLI** — Adversarial browser testing for code changes (requires `npm i -g expect-cli`)Included in `.agents/skills/` · Init: `npx -y expect-cli@latest init`License ------- [](#license) The Fission starter kit is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT). ### Health Score 55 — FairBetter than 97% of packages Maintenance91 Actively maintained with recent releases Popularity32 Limited adoption so far Community17 Small or concentrated contributor base Maturity67 Established project with proven stability Bus Factor1 Top contributor holds 98.9% 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 ~17 days Recently: every ~2 days Total 30 Last Release 50d ago Major Versions v0.4.0 → v1.0.02026-01-17 PHP version history (3 changes)v0.1.0PHP ^8.2 v1.1.0PHP ^8.5 v1.1.2PHP ^8.4 ### Community Maintainers ![](https://www.gravatar.com/avatar/e649f8d73257941573d972ca3d263116738b8b4de708d54ad107e17c38522dd2?d=identicon)[joshcirre](/maintainers/joshcirre) --- Top Contributors [![joshcirre](https://avatars.githubusercontent.com/u/8452303?v=4)](https://github.com/joshcirre "joshcirre (174 commits)")[![azatakmyradov](https://avatars.githubusercontent.com/u/23039882?v=4)](https://github.com/azatakmyradov "azatakmyradov (1 commits)")[![UnAfraid](https://avatars.githubusercontent.com/u/2185291?v=4)](https://github.com/UnAfraid "UnAfraid (1 commits)") --- Tags frameworklaravelstarter-kit ### Code Quality TestsPest Static AnalysisPHPStan, Rector Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/joshcirre-fission/health.svg) ``` [![Health](https://phpackages.com/badges/joshcirre-fission/health.svg)](https://phpackages.com/packages/joshcirre-fission) ``` ### Alternatives [codewithdennis/larament Larament is a time-saving starter kit to quickly launch Laravel 13.x projects. It includes FilamentPHP 5.x pre-installed and configured, along with additional tools and features to streamline your development workflow. 3691.5k](/packages/codewithdennis-larament)[raugadh/fila-starter Laravel Filament Starter. 614.9k](/packages/raugadh-fila-starter) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)