Skip to content

uno-forge-hub/livewire-tail-starter-kit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Livewire Starter Kit

The best way to get started with Flexiwind + Livewire. A complete, production-ready starter kit with authentication, teams, 2FA, and more — pre-configured so you can customize and ship faster.


Features

  • Authentication — Complete auth system powered by Laravel Fortify
  • Two-Factor Authentication (2FA) — TOTP-based 2FA with QR codes and recovery codes
  • Team Management — Create teams, invite members, and manage roles
  • Security — Password confirmation, session management, secure defaults
  • User Settings — Profile, password, and appearance preferences
  • Pre-configured UI — Flexiwind components ready to use
  • Phosphor Icons — Beautiful, consistent iconography

Tech Stack

Layer Technology
Framework Laravel 13 (PHP 8.4)
Frontend Livewire 4
Styling Tailwind CSS 4
UI Kit Flexiwind
Icons Phosphor Icons
Testing Pest PHP 4
Dev Tools Laravel Pint, Pail, Boost

Installation

# Clone the repository
git clone git@github.com:uno-forge-hub/livewire-tail-starter-kit.git my-app
cd my-app

# Install dependencies and setup
composer run setup

Development

Start the development environment with a single command:

composer dev

This starts:

  • Laravel development server
  • Vite dev server

Configuration

Database

Default: SQLite (configured out of the box)

To switch to MySQL/PostgreSQL, update your .env:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database
DB_USERNAME=your_username
DB_PASSWORD=your_password

Mail

Default: Log driver (emails written to log for development)

For production, configure your mail driver in .env:

MAIL_MAILER=smtp
MAIL_HOST=smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=your_username
MAIL_PASSWORD=your_password

2FA / QR Codes

2FA is ready to use. Ensure imagick or gd extension is enabled for QR code generation.


Project Structure

resources/views/
├── components/        # Reusable Flexiwind components
├── layouts/            # Page layouts (app, guest)
├── pages/
│   ├── auth/           # Login, register, 2FA, password reset
│   ├── settings/       # Profile, password, appearance
│   └── teams/          # Team management, invitations
├── dashboard.blade.php
└── welcome.blade.php

Customization

Flexiwind Components

Components are located in resources/views/components/. Customize them to match your brand:

  • ui/ — Buttons, inputs, badges, etc.
  • layout/ — Navigation, sidebar, headers
  • partials/ — Page sections and repeated patterns

Icons

This starter uses Phosphor Icons. Usage:

<x-ui.icon name="ph--house"/>

Available icons: Phosphor Icon Library

Styling

Tailwind CSS 4 with custom configuration. Main files:

  • resources/css/app.css — Main stylesheet
  • resources/css/flexiwind/ — Flexiwind utilities
  • resources/css/button-styles.css — Button variants
  • resources/css/ui-utilities.css — UI helpers

Testing

Run the test suite:

# Run all tests
composer run test

# Run with compact output
php artisan test --compact

# Run specific test
php artisan test --filter=UserTest

Code Style

# Fix code style
composer run lint

# Check code style without fixing
composer run lint:check

Included Packages


License

This starter kit is open-sourced under the MIT license.


Support

For Flexiwind-specific issues: Flexiwind Repository
For Laravel support: Laravel Documentation


Customize as you want. Ship faster.

About

The fastest way to get started with Flexiwind + Livewire

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors