Heritage WoW

Heritage WoW is a Laravel application for managing World of Warcraft characters and profession data. It supports importing profession exports, browsing recipes/items, and account login with username/password or Discord OAuth.

Features

• Character pages with owned professions and recipes
• Profession import pipeline (queued job) for sync/update
• Recipe and item listing pages
• Local authentication and Discord OAuth login
• Admin-only user management routes

Stack

• PHP/Laravel: Laravel 8
• Frontend: Blade + Tailwind CSS + Alpine.js
• Build tooling: Laravel Mix
• Database: MySQL (default in .env.example)

Local Setup

1. Install dependencies:

   composer install
   npm install
   

2. Configure environment:

   cp .env.example .env
   php artisan key:generate
   

3. Update database and OAuth values in .env (minimum: DB_*).

4. Run migrations and seeders:

   php artisan migrate --seed
   

5. Start the app and asset pipeline:

   php artisan serve
   npm run dev
   

6. If using an async queue connection for imports, run a worker:

   php artisan queue:work
   

Useful Commands

• Run tests: php artisan test
• Build production assets: npm run prod
• Create a user: php artisan user:create <username> <password>
• Create an admin user: php artisan user:create <username> <password> --admin

OAuth (Discord)

To enable Discord login, set these variables in .env:

• DISCORD_CLIENT_ID
• DISCORD_CLIENT_SECRET
• DISCORD_REDIRECT_URI

The callback route is /oauth/discord/callback.

License

This project is open-sourced software licensed under the MIT license.