PHPackages                             fuelviews/laravel-init - 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. fuelviews/laravel-init

ActiveLibrary[Framework](/categories/framework)

fuelviews/laravel-init
======================

Laravel init package

v2.0.7(6mo ago)01.3k[7 PRs](https://github.com/fuelviews/laravel-init/pulls)MITPHPPHP ^8.3CI passing

Since Oct 27Pushed 3mo ago1 watchersCompare

[ Source](https://github.com/fuelviews/laravel-init)[ Packagist](https://packagist.org/packages/fuelviews/laravel-init)[ Docs](https://github.com/fuelviews/laravel-init)[ RSS](/packages/fuelviews-laravel-init/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (11)Versions (34)Used By (0)

Laravel Init Package
====================

[](#laravel-init-package)

[![Latest Version on Packagist](https://camo.githubusercontent.com/92776791e01aa40ba0b4b382290d8ec0bea376915cd419cdee74f16e4cc6c3b2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6675656c76696577732f6c61726176656c2d696e69742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/fuelviews/laravel-init)[![GitHub Tests Action Status](https://camo.githubusercontent.com/12f09cfc752758dc971086c0605297c49ec6e25b61515d1a146f28cde4c323b5/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6675656c76696577732f6c61726176656c2d696e69742f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/fuelviews/laravel-init/actions/workflows/run-tests.yml?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/75e512f532ef9ef5a3bb18cb5a32cb987d28eedec1d947768692d5d68981981c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6675656c76696577732f6c61726176656c2d696e69742f7068702d63732d66697865722e796d6c3f6c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/fuelviews/laravel-init/actions/workflows/php-cs-fixer.yml)[![Total Downloads](https://camo.githubusercontent.com/0bd17af3fa307b77e5873586e117baf16155a1976b3c6ae3aafe26ec9f521201/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6675656c76696577732f6c61726176656c2d696e69742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/fuelviews/laravel-init)[![PHP Version](https://camo.githubusercontent.com/33430a1c9affe51d23840404e5b74e01208118f8e2e48b63a9413b89296982c7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253545382e332d626c75652e7376673f7374796c653d666c61742d737175617265)](https://php.net)[![Laravel Version](https://camo.githubusercontent.com/9a53bef6bfbb6cb990aa06777c8b0a19b5ef9f43dd3c3747bbe19bc39630167b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d2535453130253743253545313125374325354531322d7265642e7376673f7374796c653d666c61742d737175617265)](https://laravel.com)

A comprehensive Laravel initialization toolkit that streamlines the setup of Laravel applications with modern frontend tooling, SEO optimization, and the complete Fuelviews ecosystem.

Requirements
------------

[](#requirements)

- PHP ^8.3
- Laravel ^10.0 || ^11.0 || ^12.0
- Node.js (for frontend tooling)
- Composer

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

[](#installation)

Install the package via Composer:

```
cd test
```

Quick Start
-----------

[](#quick-start)

### Complete Setup (Recommended)

[](#complete-setup-recommended)

Initialize your entire Laravel application with one command:

```
php artisan init:install --force
```

Available Commands
------------------

[](#available-commands)

### Core Commands

[](#core-commands)

CommandDescriptionFlags`init:install`Complete Laravel application setup`--force`, `--dev``init:status`Check installation statusNone### Individual Component Commands

[](#individual-component-commands)

CommandDescriptionWhat it installs/configures`init:changelog`Create project changelog`CHANGELOG.md` with project details`init:composer-packages`Install Composer packagesFuelviews ecosystem + SEO packages`init:env`Configure environment`.env` with Herd integration`init:git-dot-files`Setup Git configuration`.gitattributes`, `.gitignore``init:images`Optimize imagesProcess `public/images/` directory`init:prettier`Install PrettierCode formatting with Blade support`init:tailwindcss`Install TailwindCSSComplete CSS framework setup`init:vite`Install ViteModern build tool configurationAll individual commands support `--force` and `--dev` flags.

What Gets Installed
-------------------

[](#what-gets-installed)

### Composer Packages

[](#composer-packages)

**Fuelviews Ecosystem:**

- `fuelviews/laravel-sabhero-wrapper` - Blog management
- `fuelviews/laravel-cloudflare-cache` - CDN integration
- `fuelviews/laravel-robots-txt` - SEO robots management
- `fuelviews/laravel-sitemap` - XML sitemap generation

**Third-Party Packages:**

- `ralphjsmit/laravel-seo` - Advanced SEO features
- `ralphjsmit/laravel-glide` - Image manipulation
- `livewire/livewire` - Full-stack framework
- `spatie/laravel-google-fonts` - Font optimization
- `spatie/image-optimizer` - Image optimization

### Node.js Packages

[](#nodejs-packages)

**Build Tools:**

- Vite with Laravel plugin
- PostCSS with Autoprefixer

**TailwindCSS Ecosystem:**

- TailwindCSS v3.4.17
- Forms and Typography plugins
- Custom Fuelviews color scheme

**Development Tools:**

- Prettier with Blade and Tailwind plugins
- Format scripts for automated code styling

### Configuration Files

[](#configuration-files)

FilePurposeCustomizations`vite.config.js`Build configurationLaravel integration, hot reload`tailwind.config.js`CSS frameworkFuelviews branding, Ubuntu fonts`postcss.config.js`CSS processingTailwindCSS + Autoprefixer`resources/css/app.css`Base stylesTailwind imports, Alpine.js ready`.prettierrc`Code formattingBlade template support`.env`EnvironmentLaravel Herd integration`CHANGELOG.md`Project changelogAuto-generated with project infoDevelopment vs Production Mode
------------------------------

[](#development-vs-production-mode)

### Standard Mode (Default)

[](#standard-mode-default)

```
php artisan init:install
```

- Installs stable versions of all packages
- Production-ready configuration
- Stable version constraints (e.g., `^1.0`, `^0.0`)

### Development Mode

[](#development-mode)

```
php artisan init:install --dev
```

- Installs `dev-main` versions of **Fuelviews packages only**
- Other packages remain at stable versions
- Uses `--prefer-source` for easier contribution
- Ideal for Fuelviews package development

Advanced Usage
--------------

[](#advanced-usage)

### Status Checking

[](#status-checking)

Check your installation status anytime:

```
php artisan init:status
```

This provides a comprehensive report showing:

- ✓Installed packages and versions
- ✓Configuration file status
- ✓Node package installation
- ✓Available stub files

### Image Optimization

[](#image-optimization)

Process and optimize images in your `public/images/` directory:

```
php artisan init:images
```

Features:

- Fixes file extensions based on actual MIME types
- Converts filenames to lowercase
- Optimizes file sizes (reports savings)
- Creates backups when using `--force`
- Skips optimization if savings &lt; 3KB

Optional: Install image optimization binaries on macOS:

```
brew install jpegoptim optipng pngquant gifsicle webp libavif
npm install -g svgo
```

### Selective Installation

[](#selective-installation)

Use Laravel's publishing system for selective installation:

```
# Publish only Vite configuration
php artisan vendor:publish --tag=init-vite

# Publish only TailwindCSS configuration
php artisan vendor:publish --tag=init-tailwind

# Publish all configuration files
php artisan vendor:publish --tag=init-all
```

Laravel Herd Integration
------------------------

[](#laravel-herd-integration)

This package is optimized for Laravel Herd development:

- Automatically configures `.test` domain URLs
- Sets up HTTPS with `herd secure`
- Configures proper environment variables
- Works seamlessly with Herd's PHP version management

Configuration
-------------

[](#configuration)

### TailwindCSS Customization

[](#tailwindcss-customization)

The package includes a custom TailwindCSS configuration with Fuelviews branding:

```
// Custom color scheme
colors: {
  prime: '#991b1b',      // Primary brand color
  alt: '#059669',        // Alternative accent
  cta: '#dc2626',        // Call-to-action
  background: '#f8fafc', // Page background
  // ... plus all default Tailwind colors
}

// Custom fonts
fontFamily: {
  sans: ['Ubuntu', 'ui-sans-serif', 'system-ui'],
}
```

### Vite Configuration

[](#vite-configuration)

Includes Laravel-optimized Vite setup:

```
// Hot reload paths
input: [
  'resources/css/app.css',
  'resources/js/app.js',
  'resources/views/**/*.blade.php',
  'app/Livewire/**/*.php',
  'app/Filament/**/*.php'
],

// Environment detection
server: {
  host: '0.0.0.0',
  hmr: { host: 'localhost' },
  https: detectTLS(),
}
```

Package Architecture
--------------------

[](#package-architecture)

### Commands Structure

[](#commands-structure)

- **BaseInitCommand**: Abstract base with common functionality
- **Traits**: Shared functionality (shell commands, Node packages, file publishing)
- **Service Provider**: Laravel integration and command registration
- **Facade**: Easy access to package functionality

### Design Patterns

[](#design-patterns)

- **Command Pattern**: Each installation component as separate command
- **Template Method**: Base command with customizable steps
- **Facade Pattern**: Simplified API access
- **Strategy Pattern**: Different installation modes (dev vs production)

Testing
-------

[](#testing)

The package includes comprehensive tests:

```
composer test
```

Test coverage includes:

- Command functionality and flags
- Package version logic (dev vs stable)
- Service integration
- Configuration file generation
- Installation status validation

Troubleshooting
---------------

[](#troubleshooting)

### Common Issues

[](#common-issues)

**Memory exhaustion during testing:**

- Tests use lightweight integration approach
- Complex mocking is avoided to prevent memory issues

**Node packages not installing:**

- Ensure Node.js is installed and accessible
- Check that `package.json` exists in project root
- Run `npm install` manually if needed

**Permission errors:**

- Ensure write permissions for project directory
- Use `--force` flag to overwrite protected files

**Laravel Herd integration:**

- Ensure Herd is installed and running
- Check that project is in Herd's directory
- Verify `.test` domain resolution

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

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

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Joshua Mitchener](https://github.com/thejmitchener) - Lead Developer
- [Daniel Clark](https://github.com/sweatybreeze) - Contributor
- [Fuelviews](https://github.com/fuelviews) - Organization
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

46

—

FairBetter than 93% of packages

Maintenance79

Regular maintenance activity

Popularity18

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 71.1% 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 ~15 days

Total

25

Last Release

198d ago

Major Versions

v0.0.5 → v1.0.02024-11-14

v1.0.11 → v2.0.02025-08-20

PHP version history (4 changes)v0.0.1PHP ^8.2

v1.0.6PHP ^8.1||^8.2||^8.3||^8.4

v1.0.8PHP ^8.3||^8.2

v1.0.11PHP ^8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/dd4a27681d2fe0a911a7c32f6ce4a54822748a6443892a27d7f6c651370559d8?d=identicon)[fuelviews](/maintainers/fuelviews)

---

Top Contributors

[![thejmitchener](https://avatars.githubusercontent.com/u/64335706?v=4)](https://github.com/thejmitchener "thejmitchener (27 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (9 commits)")[![fuelviews-app[bot]](https://avatars.githubusercontent.com/in/1029846?v=4)](https://github.com/fuelviews-app[bot] "fuelviews-app[bot] (2 commits)")

---

Tags

laravelinitFuelviews

###  Code Quality

TestsPest

Static AnalysisRector

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/fuelviews-laravel-init/health.svg)

```
[![Health](https://phpackages.com/badges/fuelviews-laravel-init/health.svg)](https://phpackages.com/packages/fuelviews-laravel-init)
```

###  Alternatives

[laravel/horizon

Dashboard and code-driven configuration for Laravel queues.

4.2k84.2M224](/packages/laravel-horizon)[lunarstorm/laravel-ddd

A Laravel toolkit for Domain Driven Design patterns

17959.0k](/packages/lunarstorm-laravel-ddd)[bezhansalleh/filament-plugin-essentials

A collection of essential traits that streamline Filament plugin development by taking care of the boilerplate, so you can focus on shipping real features faster

27584.7k16](/packages/bezhansalleh-filament-plugin-essentials)[vormkracht10/laravel-mails

Laravel Mails can collect everything you might want to track about the mails that has been sent by your Laravel app.

24149.7k](/packages/vormkracht10-laravel-mails)[jonpurvis/squeaky

A Laravel Validation Rule to Help Catch Profanity.

706.0k](/packages/jonpurvis-squeaky)[blendbyte/filament-title-with-slug

TitleWithSlugInput - Easy Permalink Slugs for the FilamentPHP Form Builder (PHP / Laravel / Livewire)

1322.4k3](/packages/blendbyte-filament-title-with-slug)

PHPackages © 2026

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