Documentation
Docs
Everything runs on flat files + edge workers. Zero hydration on this page. Pure static.
Quickstart
1. GitHub OAuth login → 2. Check availability → 3. Claim free → 4. Point A/CNAME/TXT/AAAA → 5. Live after Action syncs to Cloudflare.
DNS records
A for IPv4, AAAA for IPv6, CNAME for Vercel/Render/GitBook targets, TXT for site verification. Type is auto-detected from the value you point at. One CNAME per subdomain, never mixed with A/AAAA. Mail sending (SPF/DKIM/DMARC) is not supported. Edit from /app. Each save is a JSON commit.
Free forever & fair use
No packs, no credits, no checkout. ships.ng is free courtesy of Superuser Systems. Fair use is guarded: reserved names, velocity checks, and instant bans for abusers.
Reserved names
/config/reserved-names.md blocks www, api, banks, fintechs, gov. Admin edits via tags / markdown / upload.
Abuse & bans
/config/banned-users.json enforced at login + provision (403). Soft = suspend all files. Hard = purge files in one batch commit.
API & webhooks
Workers: availability check, provision commit, /api/paystack-webhook for voluntary support tips. Single zone ships.ng, staged rollout caps.
Thanks for the palette
Our dusk-plum dark theme takes its cues from the "Interactive Dashboards" palette on octet.design — River Styx blacks, Jaguar plums, Middy's Purple and Mulberry Mix accents (designs by Dmitry Lauretsky). ships.ng is free forever, so credit is our currency. Thank you.