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.
-
Both fields have defaults; the block may stay omitted.
site.config.ts queue: { estimateDays: 21, digestHourUtc: 9 },estimateDaysis what submitters are told until approvals set a rate,digestHourUtcthe reminder’s UTC hour,nullto switch it off.Terminal pnpm check:configsite.config.ts OK — <your site name> (https://your-domain.com). -
The digest’s inbox.
site.config.ts admin: { email: 'you@example.com' },Without
admin.emailit goes tosite.contactEmail;providers.adminNotifypicks the channel. -
Deploy.
Terminal pnpm deployKeep
wrangler.jsonc’s hourly trigger0 * * * *: a deploy without it clears the schedule. -
Fire the hourly job locally.
Terminal pnpm buildpnpm exec wrangler devTerminal curl "http://localhost:8787/cdn-cgi/local/scheduled?cron=0+*+*+*+*"The terminal running
wrangler devlogs 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 endsadminDigest=1.
Verify
Section titled “Verify”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 |

Worth knowing
Section titled “Worth knowing”- 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 devanswers/cdn-cgi/local/scheduledwith the site’s 404 page; build first.
When it is off or degraded
Section titled “When it is off or degraded”| 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. |
|
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 |
Configuration
Section titled “Configuration”queue.estimateDays, queue.digestHourUtc, admin.email, providers.adminNotify and tiers[].slaHours — queue, admin, providers, tiers.
- site.config.ts the
queueblock,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()andsendAdminDigest() - 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
- worker.ts
- tests/workers/jobs.test.ts the digest, the repeat guard, the snapshot