Laravel12_Vue3_Inertia_Tailwind
This is a complete Single Page Application (SPA) from the ground up using the modern VILT stack — Laravel 12, Vue 3, Inertia.js, and Tailwind CSS. This full-stack project covers everything from authentication and routing to database management and responsive frontend design.
Table of Contents
Prerequisites
Before you start, ensure you have the following installed:
- Docker: Install Docker
- Docker Compose: Install Docker Compose
- Composer: Install Composer
- PHP (Optional, if you want to run it outside Docker)
Setup Instructions
- Clone the Repository
Clone the project to your local machine:
git clone <your-repo-url>
cd <your-repo-folder>
- Set Up Environment Variables
Copy the .env.example to a new .env file:
cp .env.example .env
Edit the .env file and configure your database credentials:
DB_CONNECTION=mysql
DB_HOST=mysql
DB_PORT=3306
DB_DATABASE=your_database
DB_USERNAME=your_user
DB_PASSWORD=your_password
- Build and Start Docker Containers
Use Docker Compose to build and start the containers:
docker-compose up -d --build
This will build the containers defined in docker-compose.yml, including PHP, Nginx, PostgreSQL, and Redis.
- Install Dependencies with Composer
Install PHP dependencies inside the app container:
docker exec -it Laravel12_Vue3_Inertia_Tailwind_php composer install
If you need to install a specific package, you can run:
docker exec -it Laravel12_Vue3_Inertia_Tailwind_php composer require <package-name>
- Install front-end dependencies using npm
Install Frontend Dependencies inside the app container:
docker exec -it Laravel12_Vue3_Inertia_Tailwind_php npm install
- Generate Application Key
Run the following command to generate a new Laravel application key:
docker exec -it Laravel12_Vue3_Inertia_Tailwind_php php artisan key:generate
- Migrate the Database
Run the database migrations to set up the required tables:
docker exec -it Laravel12_Vue3_Inertia_Tailwind_php php artisan migrate --seed
Running the Application
Start Vite Dev Server ```bash
docker exec -it Laravel12_Vue3_Inertia_Tailwind_php npm run dev
Access the Application in Your Browser
After the containers are up, visit http://localhost in your browser. You should see your Laravel app running.
