Add README

This commit is contained in:
Andrew Gundersen 2026-07-16 20:15:58 +00:00
commit 50819ec8c2

21
README.md Normal file
View file

@ -0,0 +1,21 @@
# crimata-dns
Small internal API for provisioning DNS on `crimata.com` via Cloudflare — used to give each new Crimata customer a free subdomain, and optionally point a custom domain at their instance.
## What it does
- `GET /domains/check?domain=` — check domain availability
- `POST /domains` — create a subdomain for a customer, and optionally register + point a custom domain
- `DELETE /domains/:recordId` — remove a DNS record
Built with [Fastify](https://fastify.dev/) + TypeScript, talking to the Cloudflare API.
## Running it
```
cp .env.example .env # fill in Cloudflare API token, account ID, zone ID
npm install
npm run dev
```
The included `Dockerfile` builds and runs the compiled version (`npm run build` then `node dist/index.js`).