README

A production-ready Laravel starter kit combining the power of Laravel Volt with Mary UI. This package provides a complete authentication system and role-based authorization powered by Spatie's Laravel Permission package.

Features

• Laravel 12+ - Built with the latest Laravel version
• Laravel Volt - Improved Livewire component authoring experience
• Mary UI - Beautiful UI components built on top of Tailwind CSS and DaisyUI
• Authentication System - Complete authentication flow including:
  • User registration
  • Login
  • Email verification
  • Password recovery
• Role-based Authorization - User roles and permissions management using Spatie's Laravel Permission
• Admin Panel - Ready-to-use admin interface for managing users, roles, and permissions
• Modern Frontend - Tailwind CSS 4 with DaisyUI components
• Vite - Fast frontend tooling with hot module replacement

Installation

You can create a new Mary UI Starter Kit project via laravel installer:

laravel new my-app --using=chandanshakya/mary-ui-starter-kit

or using composer

composer create-project chandanshakya/mary-ui-starter-kit

Or clone the repository manually:

# Clone the repository
git clone https://github.com/ChandanShakya/mary-ui-starter-kit.git
cd mary-ui-starter-kit

# Install PHP dependencies
composer install

# Copy environment file and generate app key
cp .env.example .env
php artisan key:generate

# Set up the database
php artisan migrate --seed

# Install frontend dependencies
npm install
# or if you use Yarn
yarn

# Run the development server
php artisan serve
# In a separate terminal
npm run dev
# or
yarn dev

Development

For a streamlined development experience, you can use the provided dev command:

composer dev

This will concurrently run:

• Laravel development server
• Queue worker
• Laravel Pail for log monitoring
• Vite development server with hot module replacement

Default User Credentials

After running the migrations and seeders, you can login with the following credentials:

Requirements

• PHP 8.2+
• Composer
• Node.js & NPM

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Security Vulnerabilities

If you discover a security vulnerability within this starter kit, please send an e-mail to Chandan Shakya via email@chandanshakya.com.np. All security vulnerabilities will be promptly addressed.

License

The Mary UI Starter Kit is open-source software licensed under the MIT license.