Documentation

Promo Discounts project docs

This page explains how to work with the starter app, extend the CMS, and validate the first deploy.

Local setup

  • • Copy `.env.example` to `.env`
  • • Run the dev server
  • • Open `/admin` to create the first admin user

Content model

  • • `stores` for brands and logos
  • • `promo-codes` for coupons and active/expired state
  • • `site-settings` for the homepage shell

Publishing flow

  • • Create or edit content in Payload Admin
  • • Use the homepage to validate cards and copy actions
  • • Add new stores and promo codes as the catalog grows

Deployment

  • • Build as a single Next.js + Payload app
  • • Point Dokploy to this repo
  • • Bind the launch domain and verify the homepage, `/docs`, and admin work

Ingestion API

  • • Send `x-api-key: <API_KEY>` to `POST /api/ingest`
  • • Use the endpoint for external parser imports
  • • Payload will create or update stores and promo codes

What to add next

The next implementation pass should extend host-based site resolution, add richer site branding controls, and improve ingestion rules for parser-driven imports.