README

A professional Laravel starter template with separate admin and user dashboards using the Tabler UI kit. Perfect for quickly bootstrapping Laravel applications with a beautiful admin interface.

🚀 Features

Multi-Authentication System
- Separate admin and user areas
- Role-based access control
- Secure authentication flows
Admin Dashboard
- User Management
- Role & Permission Management
- Admin Profile Management
- Activity Logging
- Real-time Notifications
User Dashboard
- User Profile
- Account Settings
- Email Verification
- Password Management
Modern Tech Stack
- Laravel 10
- Tabler UI Kit
- Vite
- MySQL

📋 Requirements

PHP >= 8.2
Composer
Node.js & NPM
MySQL

⚡ Installation

# Clone the repository
git clone https://github.com/fxio/laravel-tabler-starter.git

# Navigate to the directory
cd laravel-tabler-starter

# Install PHP dependencies
composer install

# Install NPM dependencies
npm install

# Create environment file
cp .env.example .env

# Generate application key
php artisan key:generate

# Configure your database in .env and run migrations with seeders
php artisan migrate --seed

# Build assets
npm run build

# Start the local development server
php artisan serve

🔒 Default Credentials

Admin:

Email: admin@example.com
Password: password

User:

Email: user@example.com
Password: password

🛠 Configuration

Configure your environment variables in .env:

APP_NAME="Your App Name"
APP_URL=http://localhost:8000

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

Configure mail settings for password reset and verification:

MAIL_MAILER=smtp
MAIL_HOST=your_mail_host
MAIL_PORT=587
MAIL_USERNAME=your_username
MAIL_PASSWORD=your_password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=noreply@yourdomain.com
MAIL_FROM_NAME="${APP_NAME}"

📚 Documentation

Detailed documentation is available in the Wiki.

🔄 Updates

This project follows Semantic Versioning. To update:

composer update
npm update
php artisan migrate

🚧 Roadmap

Real-time Notifications
Advanced User Management
API Authentication
Two-Factor Authentication
Audit Logging
File Management
Theme Customization
Export/Import Features

🤝 Contributing

Contributions are welcome! Please check out our Contributing Guide.

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

📧 Support

If you discover any issues or have questions, please create an issue.

fxio / laravel-tabler-starter

Maintainers

Details