Pular para o conteúdo
Jefferson Gonçalves
← Voltar para projetos

Tailadmin Laravel Starter

The skeleton application for the Laravel framework.

#TailAdmin Laravel - Tailwind CSS Free Laravel Dashboard

TailAdmin Laravel is a modern, production-ready admin dashboard template powered by Laravel 12, Tailwind CSS v4, Alpine.js, and a clean, modular architecture. TailAdmin is one of the most popular Tailwind CSS dashboard now also available for Larvael. It’s designed for building fast, scalable admin panels, CRM dashboards, SaaS backends, and any data-driven application where clarity and performance matter. TailAdmin - Next.js Dashboard Preview

#Quick Links

Here’s a tighter, more search-friendly version that highlights value and avoids fluff while keeping your structure intact.

#✨ Key Features

  • 🚀 Laravel 12 Core - Built on the latest Laravel release with improved routing, security, and Blade templating
  • 🎨 Tailwind CSS v4 - Utility-first styling for rapid, consistent UI development
  • ⚡ Alpine.js Interactivity - Lightweight reactivity without a heavy JavaScript framework
  • 📦 Vite Build System - Fast dev server, instant HMR, and optimized production builds
  • 📱 Fully Responsive Layouts - Smooth, mobile-first design that adapts across all screen sizes
  • 🌙 Built-in Dark Mode - Ready-to-use modern dark theme for better usability and aesthetics
  • 📊 Advanced UI Components - Charts, data tables, forms, calendars, modals, and reusable blocks for complex dashboards
  • 🎯 Production-Ready Dashboard UI - Clean, modern interface crafted for real apps, not placeholder demos

#📋 Requirements

To set up TailAdmin Laravel, make sure your environment includes:

  • PHP 8.2+
  • Composer (PHP dependency manager)
  • Node.js 18+ and npm (for compiling frontend assets)
  • Database - Works with SQLite (default), MySQL, or PostgreSQL

#Tailwind CSS Laravel Dashboard

TailAdmin delivers a refined Tailwind CSS Laravel Dashboard experience, combining Laravel’s robust backend with Tailwind’s flexible utility classes. The result is a clean, fast, and customizable dashboard that helps developers build modern admin interfaces without the usual front-end complexity. It’s ideal for teams looking for a Tailwind-powered Laravel starter that stays lightweight and easy to scale.

#Laravel Admin Dashboard

If you’re searching for a dependable Laravel Admin Dashboard template that’s easy to set up and ready for production, TailAdmin fits the job. It offers a polished UI, reusable components, optimized performance, and all the essentials needed to launch dashboards, CRM systems, and internal tools quickly. It gives developers a solid foundation, so projects move faster with fewer decisions to worry about.

#Check Your Environment

Verify your installations:

php -v
composer -V
node -v
npm -v

#🚀 Quick Start Installation

#Step 1: Clone the Repository

git clone https://github.com/TailAdmin/tailadmin-laravel.git
cd tailadmin-laravel

#Step 2: Install PHP Dependencies

composer install

This command will install all Laravel dependencies defined in composer.json.

#Step 3: Install Node.js Dependencies

npm install

Or if you prefer yarn or pnpm:

# Using yarn
yarn install

# Using pnpm
pnpm install

#Step 4: Environment Configuration

Copy the example environment file:

cp .env.example .env

For Windows users:

copy .env.example .env

Or create it programmatically:

php -r "file_exists('.env') || copy('.env.example', '.env');"

#Step 5: Generate Application Key

php artisan key:generate

This creates a unique encryption key for your application.

#Step 6: Configure Database

#Option A: Using MySQL/PostgreSQL

Update your .env file with your database credentials:

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

Create the database:

# MySQL
mysql -u root -p -e "CREATE DATABASE tailadmin_db;"

# PostgreSQL
createdb tailadmin_db

Run migrations:

php artisan migrate

#Step 7: (Optional) Seed the Database

If you want sample data:

php artisan db:seed

#Step 8: Storage Link

Create a symbolic link for file storage:

php artisan storage:link

#🏃 Running the Application

#Development Mode (Recommended)

The easiest way to start development is using the built-in script:

composer run dev

This single command starts:

  • ✅ Laravel development server (http://localhost:8000)
  • ✅ Vite dev server for hot module reloading
  • ✅ Queue worker for background jobs
  • ✅ Log monitoring

Access your application at: http://localhost:8000

#Manual Development Setup

If you prefer to run services individually in separate terminal windows:

Terminal 1 - Laravel Server:

php artisan serve

Terminal 2 - Frontend Assets:

npm run dev

#Building for Production

#Build Frontend Assets

npm run build

#Optimize Laravel

# Clear and cache configuration
php artisan config:cache

# Cache routes
php artisan route:cache

# Cache views
php artisan view:cache

# Optimize autoloader
composer install --optimize-autoloader --no-dev

#Production Environment

Update your .env for production:

APP_ENV=production
APP_DEBUG=false
APP_URL=https://yourdomain.com

#🧪 Testing

Run the test suite using Pest:

composer run test

Or manually:

php artisan test

Run with coverage:

php artisan test --coverage

Run specific tests:

php artisan test --filter=ExampleTest

#📜 Available Commands

#Composer Scripts

# Start development environment
composer run dev

# Run tests
composer run test

# Code formatting (if configured)
composer run format

# Static analysis (if configured)
composer run analyze

#NPM Scripts

# Start Vite dev server
npm run dev

# Build for production
npm run build

# Preview production build
npm run preview

# Lint JavaScript/TypeScript
npm run lint

# Format code
npm run format

#Artisan Commands

# Start development server
php artisan serve

# Run migrations
php artisan migrate

# Rollback migrations
php artisan migrate:rollback

# Fresh migrations with seeding
php artisan migrate:fresh --seed

# Generate application key
php artisan key:generate

# Clear all caches
php artisan optimize:clear

# Cache everything for production
php artisan optimize

# Create symbolic link for storage
php artisan storage:link

# Start queue worker
php artisan queue:work

# List all routes
php artisan route:list

# Create a new controller
php artisan make:controller YourController

# Create a new model
php artisan make:model YourModel -m

# Create a new migration
php artisan make:migration create_your_table

#📁 Project Structure

tailadmin-laravel/
├── app/                    # Application logic
│   ├── Http/              # Controllers, Middleware, Requests
│   ├── Models/            # Eloquent models
│   └── Providers/         # Service providers
├── bootstrap/             # Framework bootstrap files
├── config/                # Configuration files
├── database/              # Migrations, seeders, factories
│   ├── migrations/
│   ├── seeders/
│   └── factories/
├── public/                # Public assets (entry point)
│   ├── build/            # Compiled assets (generated)
│   └── index.php         # Application entry point
├── resources/             # Views and raw assets
│   ├── css/              # Stylesheets (Tailwind)
│   ├── js/               # JavaScript files (Alpine.js)
│   └── views/            # Blade templates
├── routes/                # Route definitions
│   ├── web.php           # Web routes
│   ├── api.php           # API routes
│   └── console.php       # Console routes
├── storage/               # Logs, cache, uploads
│   ├── app/
│   ├── framework/
│   └── logs/
├── tests/                 # Pest test files
│   ├── Feature/
│   └── Unit/
├── .env.example           # Example environment file
├── artisan                # Artisan CLI
├── composer.json          # PHP dependencies
├── package.json           # Node dependencies
├── vite.config.js         # Vite configuration
└── tailwind.config.js     # Tailwind configuration

#🐛 Troubleshooting

#Common Issues

#"Class not found" errors

composer dump-autoload

#Permission errors on storage/bootstrap/cache

chmod -R 775 storage bootstrap/cache

#NPM build errors

rm -rf node_modules package-lock.json
npm install

#Clear all caches

php artisan optimize:clear

#Database connection errors

  • Check .env database credentials
  • Ensure database server is running
  • Verify database exists

#License

Refer to our LICENSE page for more information.

Nova versão disponível.