First deploy checklist

Vercel setup

This app targets Vercel with Upstash Redis for state and Vercel Blob for uploaded/generated images.

1. Add storage integrations

  • Add Upstash Redis to the Vercel project.
  • Add Vercel Blob to the Vercel project.

2. Configure environment variables

  • ADMIN_USERNAME
  • ADMIN_PASSWORD
  • UPSTASH_REDIS_REST_URL
  • UPSTASH_REDIS_REST_TOKEN
  • BLOB_READ_WRITE_TOKEN
  • IMAGE2_API_BASE_URL
  • IMAGE2_API_KEY
  • IMAGE2_SUBMIT_PATH
  • IMAGE2_STATUS_PATH
  • IMAGE2_TIMEOUT_MS

3. First admin login

  • The app auto-creates the first admin from `ADMIN_USERNAME` and `ADMIN_PASSWORD`.
  • Open `/admin/login` after deploy and sign in once.

4. image2 placeholder mode

If `IMAGE2_API_BASE_URL` is empty, the app keeps the full upload, job, and download flow but returns the uploaded image as the generated result. This is useful for smoke-testing the whole site before wiring the real upstream API.