wireninja/prasmanan

The opinionated Filament Super Booster kit by WireNinja.

Maintainers

Package info

github.com/WireNinja/prasmanan

Type:composer-plugin

pkg:composer/wireninja/prasmanan

Statistics

Installs: 31

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0


README

"Super Booster" library for Filament PHP by WireNinja.

Onboarding

  1. Install Package

    composer require wireninja/prasmanan -W
  2. Initialize Project (Interactive)

    php artisan prasmanan:init

    Syncs .env, .env.example, package.json, Vite, CSS, Enums, and Core Migrations.

  3. Publish Configuration (Optional)

    php artisan vendor:publish --tag=prasmanan-config

    Allows overriding default behaviors in config/prasmanan.php.

  4. Verify Health

    php artisan prasmanan:audit

    Run with --production before deployment.

Core Commands

Command Description
prasmanan:audit Audit project health & readiness (Tabular View).
prasmanan:init Setup/Reset project to Prasmanan standards.
prasmanan:env-sync Force sync .env.example with defaults.
prasmanan:system-format Format code using opinionated Pint preset.
prasmanan:system-refresh Pure database reset (migrate:fresh --seed).

Development Workflow

  1. Start: Run prasmanan:init on fresh projects.
  2. Coding: Use standard Filament & Prasmanan utility classes.
  3. Commit: Run prasmanan:system-format --dirty before pushing.
  4. Deploy: Run prasmanan:audit --production for pre-flight check.

Blade Directives

For non-Filament pages (e.g. landing pages or custom layouts), you can use these directives to inject Prasmanan features:

  • PWA Assets:

    @prasmananPwa

    Place this inside your <head> tag. It injects manifest, meta tags, and icons.

  • Real-time Broadcasting:

    @prasmananBroadcasting

    Place this before </body>. It injects Echo listeners and notification handlers.

Developed with Passion by WireNinja.