Admin Web App Setup (Laravel + Vue + Inertia.js)

The Admin Web App is built using Laravel, Vue.js, and Inertia.js. Follow the steps below to set it up on your system.

1. Install Dependencies

We use pnpm instead of npm for better performance and efficient package management.
pnpm works like npm but uses a content-addressable storage system to save disk space.

# Install pnpm globally
npm install -g pnpm

# Install project dependencies
pnpm install
      

2. Laravel Setup

Make sure you have PHP, Composer, and a database (MySQL or PostgreSQL) installed. Then install Laravel dependencies:

composer install

3. Environment Configuration

Copy the example environment file and update it:

cp .env.example .env

Open .env and configure your database, mail, and app settings.

4. Generate Keys

Laravel requires an APP_KEY for encryption and a JWT_SECRET for authentication tokens.

# Generate new APP_KEY
php artisan key:generate

# Generate JWT Secret
php artisan jwt:secret
      

This will automatically update your .env file with the new keys:

APP_KEY=base64:XXXXXXXXXXXXXXXXXXXXXX
JWT_SECRET=XXXXXXXXXXXXXXXXXXXXXXXXXX
      

5. Run Database Migrations

php artisan migrate --seed

6. Configure Environment Variables

Open your .env file and add or update the following keys as required:

# -------------------------------
# LaraBug Error Tracking
# -------------------------------
LB_KEY=             # Your LaraBug API key for error tracking
LB_PROJECT_KEY=     # LaraBug project key used to identify your app

# -------------------------------
# Razorpay Payment Integration
# -------------------------------
RAZORPAY_KEY=           # Public key from Razorpay Dashboard
RAZORPAY_SECRET=        # Secret key from Razorpay Dashboard
RAZORPAY_WEBHOOK_SECRET=# Webhook secret key for verifying Razorpay webhooks

7. Build Frontend

pnpm dev   # Development mode
pnpm build # Production build

8. Configure Seeder

Go to database/seeders/SchoolUser.php and edit it as per your requirements. Then run the following command:

php artisan db:seed SchoolUser

9. Start the Server

php artisan serve

✅ Your Admin Web App is now ready! Access it at http://localhost:8000