PHPackages                             vall-here/nvlaravel - 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. [CLI &amp; Console](/categories/cli)
4. /
5. vall-here/nvlaravel

ActiveLibrary[CLI &amp; Console](/categories/cli)

vall-here/nvlaravel
===================

Composable, enterprise-grade project scaffolding CLI for Laravel applications.

v1.1.0(today)13↑2900%MITPHPPHP ^8.2

Since Aug 25Pushed todayCompare

[ Source](https://github.com/Vall-Here/nvlaravel)[ Packagist](https://packagist.org/packages/vall-here/nvlaravel)[ Docs](https://github.com/Vall-Here/nvlaravel)[ RSS](/packages/vall-here-nvlaravel/feed)WikiDiscussions master Synced today

READMEChangelog (2)Dependencies (4)Versions (3)Used By (0)

```
          _                           _
  _ ____   _| | __ _ _ __ __ ___   _____| |
 | '_ \ \ / / |/ _` | '__/ _` \ \ / / _ \ |
 | | | \ V /| | (_| | | | (_| |\ V /  __/ |
 |_| |_|\_/ |_|\__,_|_|  \__,_| \_/ \___|_|

      Composable Laravel Generator

```

Composable project scaffolding CLI for Laravel applications. Enables multi-layered stack combinations with automatic dependency resolution and atomic rollback.

Supported Configuration Layers
------------------------------

[](#supported-configuration-layers)

nvlaravel scaffolds projects based on composable options across the following domains. All options can be combined freely.

### Rendering

[](#rendering)

OptionPackageBlade Templating EngineLaravel built-inInertia.js (with SSR support)`inertiajs/inertia-laravel`### Reactivity

[](#reactivity)

OptionPackageLivewire v3 (navigate, polls, uploads, lazy loading, validation, events)`livewire/livewire`Livewire Flux`livewire/flux`Livewire Power Grid Tables`power-components/livewire-powergrid`Alpine.js (with plugins: persist, intersect, focus, collapse, mask, anchor)npm `alpinejs`HTMX (with alpine-morph extension)npm `htmx.org`Turbonpm `@hotwired/turbo`### JavaScript Frameworks

[](#javascript-frameworks)

OptionPackageReact (TypeScript, latest)npm `react`Vue.js (TypeScript, latest)npm `vue`### JavaScript Utilities

[](#javascript-utilities)

UtilityPackageAxiosnpm `axios`Lodashnpm `lodash`Day.jsnpm `dayjs`Zodnpm `zod`Alpine AJAXnpm `@imacrayon/alpine-ajax`### CSS Frameworks

[](#css-frameworks)

OptionPackageTailwind CSS v4 (with forms, typography, container queries, dark mode)npm `tailwindcss`Tailwind CSS v3 (PostCSS + tailwind.config.js)npm `tailwindcss@3`Bootstrapnpm `bootstrap`### UI Libraries

[](#ui-libraries)

OptionPackageFlowbite (with datepicker, modal, dropdown, tooltip plugins)npm `flowbite`Shadcn UInpm `shadcn-ui`DaisyUInpm `daisyui`Preline UInpm `preline`Headless UInpm `@headlessui/vue` or `@headlessui/react`### UI Components

[](#ui-components)

ComponentPackageCharts (Chart.js)npm `chart.js`Rich Text Editor (Tiptap)npm `@tiptap/vue-3`Datepicker (Flatpickr)npm `flatpickr`Sortable (SortableJS)npm `sortablejs`Maps (Mapbox)npm `mapbox-gl`File Upload (Drag &amp; Drop)Built-in LivewireData Tables (Power Grid)`power-components/livewire-powergrid`Select (Tom Select)npm `tom-select`Toast Notifications (SweetAlert2)npm `sweetalert2`### Icons &amp; Notifications

[](#icons--notifications)

OptionPackageHeroicons (with Blade Icons integration)`blade-ui-kit/blade-heroicons`Toast Notifications (Notyf)npm `notyf`### Authentication

[](#authentication)

OptionPackageLaravel Breeze (UI scaffolding)`laravel/breeze`Laravel Fortify (headless auth with login, register, password reset, email verification, 2FA)`laravel/fortify`Laravel Socialite (OAuth: Google, GitHub)`laravel/socialite`Magic Link loginConfigurableAPI Auth via Sanctum (SPA + token)`laravel/sanctum`API Auth via Passport`laravel/passport`### Authorization

[](#authorization)

OptionPackageSpatie Permission (Roles &amp; Permissions, Teams support)`spatie/laravel-permission`Laravel PoliciesBuilt-in### Multi-tenancy &amp; User Management

[](#multi-tenancy--user-management)

OptionPackageMulti-tenancy (single database strategy)`stancl/tenancy`User Impersonation`lab404/laravel-impersonate`### API

[](#api)

OptionNotesREST API with versioning (v1 prefix)Built-in routingPagination, filtering, sortingBuilt-inAPI Resources (JSON response wrappers)Built-inRate limiting (60 req/min default)Built-inAPI Documentation (Scramble, Swagger UI)`dedoc/scramble`Query Builder`spatie/laravel-query-builder`### Realtime

[](#realtime)

OptionPackageLaravel Reverb (WebSocket server)`laravel/reverb`Laravel Echo (frontend client)npm `laravel-echo`### Database

[](#database)

OptionNotesPostgreSQL / MySQL / SQLiteConfigurableEloquent ORMBuilt-inULID primary keysBuilt-inSoft deletes, foreign keys, indexes, transactionsBuilt-inDatabase seeding with Faker (locale: id\_ID)Built-inDatabase backup (scheduled daily to S3)`spatie/laravel-backup`### Infrastructure

[](#infrastructure)

OptionPackage / NotesCache (Redis)Built-inQueue (Redis + Horizon monitor)`laravel/horizon`File storage (Local, S3, Public)Built-inFull-text search (Meilisearch + Scout)`laravel/scout` + `meilisearch/meilisearch-php`Mail (SMTP + Markdown templates, Resend provider)Built-inSMS (Twilio)ConfigurableCDN (CloudFront)ConfigurableDeployment (Forge, GitHub Actions, Docker/Sail)Configurable### Observability

[](#observability)

OptionPackageLogging (daily driver, JSON format)Built-inDebugbar`barryvdh/laravel-debugbar`Telescope`laravel/telescope`Ray (Spatie)`spatie/ray`Error tracking (Sentry)`sentry/sentry-laravel`Metrics (Prometheus)ConfigurableDistributed tracing (OpenTelemetry)ConfigurableUptime monitoring (Oh Dear)Configurable### Packages

[](#packages)

PackageComposerSpatie Media Library (conversions, responsive images)`spatie/laravel-medialibrary`Spatie Activity Log`spatie/laravel-activitylog`Spatie Settings`spatie/laravel-settings`Spatie Query Builder`spatie/laravel-query-builder`Spatie Sluggable`spatie/laravel-sluggable`Spatie Translatable`spatie/laravel-translatable`Spatie Sitemap`spatie/laravel-sitemap`Spatie Schedule Monitor`spatie/laravel-schedule-monitor`Spatie Model States`spatie/laravel-model-states`Spatie Laravel Health`spatie/laravel-health`Spatie Backup`spatie/laravel-backup`SEO Tools`artesaos/seotools`Payments (Midtrans, Xendit, Stripe/Cashier)`laravel/cashier`Notifications (Mail, Database, Slack, WhatsApp, FCM)`netflie/whatsapp-cloud-api`PDF Generation (DomPDF)`barryvdh/laravel-dompdf`Image Processing`intervention/image`Excel Import/Export`maatwebsite/excel`Geocoding`geocoder-php/geocoder`Idempotency / Fractal`spatie/laravel-fractal`### Testing &amp; Code Quality

[](#testing--code-quality)

OptionPackagePest PHP (Unit, Feature, API tests)`pestphp/pest`Browser testing (Laravel Dusk)`laravel/dusk`Code coverage (min. 70%)Built-inStatic analysis (PHPStan level 5 + Larastan)`nunomaduro/larastan`Code formatting (Laravel Pint)`laravel/pint`Refactoring (Rector)`rector/rector`### Code Architecture

[](#code-architecture)

OptionNotesModular domain structure`app/Services`, `app/Actions`, `app/Data`, `app/Queries`, `app/Repositories`Service, Action, DTO, Query, Policy, Event patternsBuilt-in---

Installation
------------

[](#installation)

You can install and use nvlaravel via three different methods:

### Method 1: Standalone Executable (Recommended)

[](#method-1-standalone-executable-recommended)

Download the pre-compiled standalone binary to avoid any global Composer conflicts. This is a single, self-contained file that runs anywhere.

**For macOS / Linux:**

1. Download the executable directly from the terminal: ```
    curl -sL https://github.com/vall-here/nvlaravel/releases/latest/download/nvlaravel -o nvlaravel
    ```
2. Make it executable: ```
    chmod +x nvlaravel
    ```
3. Move it to your system PATH to use it globally: ```
    sudo mv nvlaravel /usr/local/bin/
    ```
4. Run the wizard from anywhere: ```
    nvlaravel new my-app
    ```

**For Windows:**

1. **Download the File**: Download the `nvlaravel` executable from the [latest GitHub Releases](https://github.com/vall-here/nvlaravel/releases).
2. **Create a Dedicated Folder**: Create a new folder on your computer where you will store command-line tools. For example: `C:\tools\nvlaravel\`
3. **Move the File**: Move the downloaded `nvlaravel` file into this new folder (`C:\tools\nvlaravel\nvlaravel`).
4. **Create a Batch Wrapper**: To run it like a native Windows command, create a new text file in the same folder, name it `nvlaravel.bat`, and add this exact content: ```
    @php "%~dp0nvlaravel" %*
    ```
5. **Add to System PATH**:
    - Press the Windows Key, type **Environment Variables**, and select **Edit the system environment variables**.
    - Click the **Environment Variables** button at the bottom.
    - Under **System variables** (or User variables), find the `Path` variable, select it, and click **Edit**.
    - Click **New** and paste the path to your folder: `C:\tools\nvlaravel\`
    - Click **OK** on all windows to save.
6. **Restart Terminal**: Close and reopen your Command Prompt or PowerShell, then test the command from anywhere: ```
    nvlaravel new my-app
    ```

### Method 2: Global Composer

[](#method-2-global-composer)

If your global Composer environment is clean, you can install it globally:

```
composer global require vall-here/nvlaravel
```

*(Ensure your global Composer bin directory is in your system `PATH`.)*

### Method 3: Isolated Composer Project

[](#method-3-isolated-composer-project)

If you prefer to keep the generator isolated but still use Composer:

```
composer create-project vall-here/nvlaravel my-generator
cd my-generator
php nvlaravel new my-app
```

Usage
-----

[](#usage)

Create a new Laravel project using the interactive wizard:

```
nvlaravel new my-app
```

### Interactive Demo &amp; Workflow

[](#interactive-demo--workflow)

When you run the command above, `nvlaravel` will guide you through a beautiful, interactive CLI prompt. You can mix and match any stack you want!

**Example Interaction:**

```
  _                           _
 _ ____   _| | __ _ _ __ __ ___   _____| |
| '_ \ \ / / |/ _` | '__/ _` \ \ / / _ \ |
| | | \ V /| | (_| | | | (_| |\ V /  __/ |
|_| |_|\_/ |_|\__,_|_|  \__,_| \_/ \___|_|

✨ Welcome to nvlaravel - The Composable Laravel Generator!

? Select a preset (or choose 'Custom' to build your own):
  › Custom (Interactive Wizard)
    Classic (Blade + Livewire + Alpine + Tailwind + Vite)
    Inertia React (React + Tailwind + Vite)
    Inertia Vue (Vue + Tailwind + Vite)

? Select Laravel Framework Version:
  › Laravel Latest (v13+)

? Server Rendering Engine:
  › Inertia.js Monolith Adapter

? JavaScript Component Libraries:
  ◼ React
  ◻ Vue.js

? Backend & Infrastructure Packages:
  ◼ Laravel Breeze (Auth UI Scaffolding)
  ◼ Spatie Permission (Roles & Permissions)

? Development & Workflow Tools:
  ◼ Auto-create SQLite database & run migrations
  ◼ Generate GitHub Actions CI/CD Pipeline

```

**What Happens Next?**Behind the scenes, the generator's **Execution Engine** kicks in:

1. **Dependency Resolution**: It calculates that React requires Vite, and Breeze conflicts with Fortify.
2. **Context-Aware Scaffolding**: It detects that you chose `Breeze`, so it intelligently *skips* overwriting `app.jsx` to preserve Breeze's Authentication boilerplate, while still injecting `HasRoles` into your `User` model for Spatie Permission.
3. **Execution**:

```
  ✓ Base Laravel Framework (latest) initialized at /var/www/my-app
  ✓ Laravel Breeze installed with [react] stack.
  ✓ Spatie Permission installed, config published, and HasRoles trait added to User model.
  ✓ Database initialized (SQLite) and migrations executed successfully.
  ✓ GitHub Actions CI/CD Pipeline workflow generated.

```

**End Result**: You get a fully functional, production-ready Laravel monolith. You can just `cd my-app && php artisan serve` and everything (Auth, DB, Permissions, CI/CD) works immediately out-of-the-box!

### Using Presets

[](#using-presets)

```
nvlaravel new my-app --preset=classic
```

Available presets:

Preset KeyStack`classic`Blade + Livewire v3 + Alpine.js + Tailwind CSS + Vite`inertia-react`Inertia.js + React + TypeScript + Tailwind CSS + Vite`inertia-vue`Inertia.js + Vue.js + TypeScript + Tailwind CSS + Vite`htmx-stack`Blade + HTMX + Alpine.js + Tailwind CSS + Vite### CLI Options

[](#cli-options)

FlagDescriptionValues`--preset`Pre-configured stack preset`classic`, `inertia-react`, `inertia-vue`, `htmx-stack``--laravel-version`Target Laravel version`latest`, `12`, `11``--tailwind-version`Target Tailwind CSS version`v4`, `v3`Technical Architecture
----------------------

[](#technical-architecture)

The core engine follows a 4-layer execution pipeline:

1. **Blueprint (`App\Configuration\Blueprint`)**: Registry loading technology definitions, dependencies, and conflict matrices from `config/generator.php`.
2. **RuntimeConfig (`App\Configuration\RuntimeConfig`)**: State container holding user selections.
3. **Resolver (`App\Dependency\Resolver`)**: Dependency resolution using recursive topological sorting and circular dependency detection.
4. **ExecutionPlan (`App\Planning\ExecutionPlan`)**: Sequence generator ordering task handlers.
5. **Executor (`App\Engine\Executor`)**: Handler pipeline running composer, npm, and stub transformations.

### Safety Mechanisms

[](#safety-mechanisms)

- **EnvironmentDoctor (`App\Services\EnvironmentDoctor`)**: Pre-check for PHP, Composer, and NPM binaries and minimum versions before any execution.
- **RollbackManager (`App\Services\RollbackManager`)**: Atomic rollback deleting partially created directories upon any failure during scaffolding.

Development &amp; Testing
-------------------------

[](#development--testing)

Run unit tests with Pest:

```
./vendor/bin/pest
```

Compile standalone Phar executable:

```
php -d phar.readonly=0 build_phar.php
```

Contributing
------------

[](#contributing)

We welcome contributions from the community! Whether it's a bug fix, a new feature, or an improvement to the documentation, your help is appreciated.

### Reporting Issues

[](#reporting-issues)

If you find a bug or have a feature request, please open an issue on the [GitHub Issues](https://github.com/vall-here/nvlaravel/issues) page. Include as much detail as possible to help us understand the problem.

### Submitting Pull Requests

[](#submitting-pull-requests)

1. Fork the repository.
2. Create a new branch for your feature or bugfix (`git checkout -b feature/your-feature-name`).
3. Make your changes and commit them with clear, descriptive messages (`git commit -m "Add some feature"`).
4. Push your branch to your fork (`git push origin feature/your-feature-name`).
5. Open a Pull Request against the `main` branch of this repository.

Ensure your code follows the existing style and passes all tests by running `./vendor/bin/pest`.

License
-------

[](#license)

MIT License.

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance100

Actively maintained with recent releases

Popularity6

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~0 days

Total

2

Last Release

0d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/149749575?v=4)[ahmadNoval](/maintainers/Vall-Here)[@Vall-Here](https://github.com/Vall-Here)

---

Top Contributors

[![Vall-Here](https://avatars.githubusercontent.com/u/149749575?v=4)](https://github.com/Vall-Here "Vall-Here (10 commits)")

---

Tags

composerlaraveltoolsclilaravelgeneratorscaffoldbladelivewiretailwindinertiareactvuehtmx

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/vall-here-nvlaravel/health.svg)

```
[![Health](https://phpackages.com/badges/vall-here-nvlaravel/health.svg)](https://phpackages.com/packages/vall-here-nvlaravel)
```

###  Alternatives

[mehrancodes/laravel-harbor

A CLI tool to Quickly create On-Demand preview environment for your apps.

99100.2k](/packages/mehrancodes-laravel-harbor)[joshcirre/tweakflux

Deep theming for Flux UI. Override Tailwind v4 CSS custom properties to transform every Flux component.

11714.0k](/packages/joshcirre-tweakflux)[carbon/pipeline

Ultra-fast build stack for Neos CMS based on esbuild and PostCSS

1729.9k1](/packages/carbon-pipeline)[timwassenburg/laravel-repository-generator

Generate Laravel repositories

2119.9k1](/packages/timwassenburg-laravel-repository-generator)

PHPackages © 2026

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