Skip to content
Early bird + Black Friday · 73% off

Get ZeroDirs for $179 $49

Claim $49 deal

The review queue

The queue gives a free submitter a wait estimate and mails you a daily digest. Part of features.submissions, tuned by the queue block in site.config.ts.

  1. Both fields have defaults; the block may stay omitted.

    site.config.ts
    queue: { estimateDays: 21, digestHourUtc: 9 },

    estimateDays is what submitters are told until approvals set a rate, digestHourUtc the reminder’s UTC hour, null to switch it off.

    Terminal
    pnpm check:config

    site.config.ts OK — <your site name> (https://your-domain.com).

  2. The digest’s inbox.

    site.config.ts
    admin: { email: 'you@example.com' },

    Without admin.email it goes to site.contactEmail; providers.adminNotify picks the channel.

  3. Deploy.

    Terminal
    pnpm deploy

    Keep wrangler.jsonc’s hourly trigger 0 * * * *: a deploy without it clears the schedule.

  4. Fire the hourly job locally.

    Terminal
    pnpm build
    pnpm exec wrangler dev
    Terminal
    curl "http://localhost:8787/cdn-cgi/local/scheduled?cron=0+*+*+*+*"

    The terminal running wrangler dev logs one line:

    jobs: expireFeatured=0 flushOutbox=0 retryRebuilds=0 purgeUnpaid=0 adminDigest=0 (cron=0 * * * *, in <n>ms)

    &time=<milliseconds since the epoch> moves the tick; in the digest hour with a free submission pending it ends adminDigest=1.

Submit a free listing locally (pnpm dev, then /submit/).

What to check Where You should see
The estimate the status page after “Submit for review” “Expected to go live in about 3 weeks — number 1 in the queue.” on a fresh local database
The receipt the submitted row in email_outbox a queue.wait of the same phrase, plus queue.upgrades when paid plans are on
The tiles /admin/ “In the free queue” counts it; “Wait submitters are told” shows the phrase and its basis
The digest fire the hourly job at the digest hour (step 4) adminDigest=1 in the log line and an admin-digest row in email_outbox

The status page: go-live estimate, queue position, Skip the queue offer

  • The approval rate behind the estimate counts only source = 'submit' rows; seeded, imported and admin-created listings never shorten the wait.
  • “Skip the queue” opens Stripe Checkout with ?tier=; the tier changes only on payment.
  • No digest if one was queued in the last twenty hours, or nothing approvable waits.
  • astro dev answers /cdn-cgi/local/scheduled with the site’s 404 page; build first.
Configuration What a submitter sees What /admin/ shows Fix
queue.digestHourUtc: null unchanged no digest arrives set an hour
providers.adminNotify: 'off' unchanged no digest, no per-submission notification set it to 'same'
no approvals in the last 30 days “in about 3 weeks” on the defaults the tile reads “queue.estimateDays, until approvals set a rate” approve submissions, or lower estimateDays
providers.email: 'console' — the digest is logged, not sent; warning: providers.email is "console": submitters get no mail, it is only logged. Email
features.payments: false, providers.payment: 'none', or no priced tier enabled no “Skip the queue” section; no upgrade sentence in the receipt — Plans and payments
the cron trigger removed from wrangler.jsonc unchanged no digest; queued mail waits until something else flushes it restore triggers.crons and redeploy

queue.estimateDays, queue.digestHourUtc, admin.email, providers.adminNotify and tiers[].slaHours — queue, admin, providers, tiers.

  • site.config.ts the queue block, admin.email, providers.adminNotify
  • wrangler.jsonc triggers.crons
  • Directorysrc/
    • worker.ts scheduled(), the cron entry
    • Directoryserver/
      • queue.ts the estimate, the wording, the upgrade sentence, the one-query snapshot
      • jobs.ts runJobs() and sendAdminDigest()
      • queries.ts the dashboard’s queue numbers
      • Directoryemail/templates/
        • admin-digest.ts the reminder
        • submitted.ts the receipt with the wait
    • Directorypages/submit/status/
      • [token].astro computes the estimate and the upgrade links
    • templates/submit/StatusPage.astro “Skip the queue”
    • templates/admin/DashboardPage.astro the tiles
  • tests/workers/jobs.test.ts the digest, the repeat guard, the snapshot