Wirement - TALL Starter Pack

Modern Laravel starter pack with Flux UI Pro v2 and Livewire 4

Wirement is a bloat-free starter kit for quickly launching Laravel 12 projects. It comes with Flux UI Pro v2 and Livewire 4 pre-configured, plus essential tools to speed up your development—nothing more, nothing unnecessary.

Features

Frontend Stack

• Flux UI Pro v2 - Modern, Apple-inspired component library (requires license)
• Tailwind CSS 4.0 - Utility-first CSS framework
• Hero Icons - Beautiful, customizable icons
• Alpine.js - Lightweight JavaScript framework (included with Livewire)

Backend Stack

• Laravel 12 - Latest PHP framework
• Livewire 4 - Dynamic full-stack components
• SQLite - Zero-config database (swap to MySQL/Postgres as needed)

Pre-configured Features

• Authentication - Login with Flux UI components
• Admin Panel - Livewire-based user management at /admin
• Flux UI Components - Beautiful UI components throughout
• Database Seeding - Default admin user
• Asset Pipeline - Vite with Tailwind CSS
• Code Quality - Laravel Pint, PHPStan, Rector, Pest testing

Quick Start

Requirements

• PHP 8.3+
• Composer
• Node.js & npm
• Laravel Herd (recommended)

Installation

1. Clone the repository

git clone https://github.com/kwhorne/wirement.git
cd wirement

2. Install dependencies

composer install
npm install

3. Environment setup

cp .env.example .env
php artisan key:generate

4. Database setup

php artisan migrate --seed

5. Build assets

npm run build

6. Start development server

composer run dev
# or use Laravel Herd

Project Structure

wirement/
├── app/
│   ├── Livewire/
│   │   ├── Auth/              # Login component
│   │   └── Admin/Users/       # User CRUD components
│   ├── Models/                # Eloquent models
│   └── Http/
│       └── Requests/          # Form request validation
├── resources/
│   └── views/
│       ├── layouts/            # Admin and guest layouts
│       └── livewire/          # Livewire component views
├── database/
│   ├── migrations/            # Database migrations
│   └── seeders/               # Database seeders
└── routes/                    # Application routes

Access Points

• Public Site: http://wirement.test
• Admin Panel: http://wirement.test/admin
• Login: http://wirement.test/login

Configuration

Flux UI Icons

Import icons using the built-in Artisan command:

php artisan flux:icon crown grip-vertical github

Development Commands

Wirement includes convenient composer commands:

composer review  # Run Pint, Rector, PHPStan, and Pest
composer test    # Run Pest test suite
composer pint    # Fix code style with Pint
composer dev     # Start all dev services concurrently

Default Credentials

For development purposes, a default admin user is created:

• Email: admin@example.com
• Password: password

Security Note: Change the default password before deploying to production.

Development Workflow

Database Seeding

php artisan migrate:fresh --seed

Asset Development

npm run dev    # Development mode with HMR
npm run build  # Production build

Testing

php artisan test              # Run all tests
php artisan test --compact    # Compact output

Key Dependencies

• laravel/framework: ^12.0
• livewire/livewire: ^4.0
• livewire/flux-pro: ^2.2 (requires license)
• tailwindcss: ^4.0

Production Deployment

Before deploying to production:

1. Environment Configuration

   • Set APP_ENV=production
   • Configure secure database credentials
   • Set up proper mail configuration

2. Security Checklist

   • Change default passwords
   • Enable HTTPS/SSL
   • Configure proper file permissions
   • Set up rate limiting

3. Performance Optimization

   • Enable caching (php artisan config:cache)
   • Optimize autoloader (composer install --optimize-autoloader)
   • Configure queue workers for background jobs

Customization

Adding New Livewire Components

php artisan make:livewire Admin/YourComponent

Flux UI Components

Wirement is built with Flux UI Pro v2 components. Check the Flux UI documentation for usage examples and licensing information.

What's Included

• Laravel 12 Foundation
• Livewire 4 Full-stack Components
• Flux UI Pro v2 (requires license)
• Tailwind CSS 4.0
• Alpine.js Integration
• Login Authentication
• User Management (CRUD)
• Vite Asset Pipeline
• Database Migrations & Seeding
• Code Quality Tools (Pint, PHPStan, Rector)
• Pest Testing Framework

Support

If you encounter any issues or have questions:

1. Check the Laravel documentation
2. Consult Flux UI documentation
3. Review Livewire documentation
4. Open an issue on GitHub

Next Steps

After installation, you can:

1. Log in - Navigate to /login with the default credentials
2. Manage Users - Go to /admin to manage users
3. Customize the Design - Modify layouts and components to match your brand
4. Add Your Models - Create Eloquent models and Livewire components
5. Build Your Frontend - Use Flux UI components in your Blade templates

---

Built by Knut W. Horne - Innovative digital solutions for modern web development