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.3.0(2mo ago)20925426[3 PRs](https://github.com/joshcirre/fission/pulls)MITPHPPHP ^8.4CI passing

Since Nov 12Pushed 1w ago4 watchersCompare

[ Source](https://github.com/joshcirre/fission)[ Packagist](https://packagist.org/packages/joshcirre/fission)[ RSS](/packages/joshcirre-fission/feed)WikiDiscussions main Synced today

READMEChangelog (10)Dependencies (60)Versions (36)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
----

[](#flux)

Fission uses [Livewire Flux](https://fluxui.dev) (free) for its UI components. No Flux Pro license is required out of the box.

If you want access to premium components (date pickers, calendars, charts, tabs, and more), you can install Flux Pro during setup when prompted for optional packages. Fission does not include any of Flux's CSS or built assets — you must have the package installed to use it.

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
- Optional packages (Flux Pro, Filament, Bento, etc.)
- 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

56

—

FairBetter than 97% of packages

Maintenance92

Actively maintained with recent releases

Popularity32

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity68

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 ~8 days

Total

31

Last Release

81d 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 (179 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.

3891.8k](/packages/codewithdennis-larament)[nasirkhan/laravel-starter

A CMS like modular Laravel starter project.

1.4k2.7k](/packages/nasirkhan-laravel-starter)[unopim/unopim

UnoPim Laravel PIM

10.5k2.4k](/packages/unopim-unopim)[raugadh/fila-starter

Laravel Filament Starter.

625.1k](/packages/raugadh-fila-starter)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
