📖 Handbook & Update Log

The central source of truth for Project Arceus. This page contains critical startup information and a running log of major updates.

🚀 Session Startup Instructions

Follow these steps every time you start a new development session to ensure the application runs correctly.

  1. Start the Frontend: Open a terminal and run the Next.js development server.
    npm run dev
    The app will be available at http://localhost:3000
  2. Start the Python Worker: Open a second, separate terminal and run the Python worker.
    py worker/worker.py
    This worker processes uploaded binder images to detect and identify cards.
  3. Current Functionality: Upload binder photos → automatic card detection → high-quality individual crops
    • Navigate to /upload to submit new binder photos
    • View processing results at /scans
    • Review detected cards at /scans/review
  4. Database: Connected to live Supabase instance. No local setup required.

📝 Project History & Patterns