# Host recruiting tracker with Next.js: relational workspace data

Deploy a recruiting tracker built with Next.js on Ample using the relational records pattern. Compute runs the app in an isolated microVM behind a public HTTPS URL, a managed PostgreSQL 16 database is auto-provisioned and injected as DATABASE_URL. Verified on Next.js: a workspace-scoped table, an explicit state machine (draft to review to published) that rejects invalid transitions, and a cross-workspace read that returns nothing (transitions=true isolation=true). Not separately tested: your record schema, states and access rules; treat the recruiting tracker-specific behavior as your application code.

## Summary
- **Framework**: Next.js
- **Workload**: Recruiting tracker
- **Release Status**: published
- **Support Status**: verified
- **Execution Status**: ready
- **Docs Only**: false

### Resource Requirements
- **Compute**
- **Postgres**

### Infrastructure Requirements
| Primitive ID         | Label   | Status   | Summary  |
|---------------------|---------|----------|----------|
| primitive:compute   | Compute | verified  | Apps run in isolated x86_64 Firecracker microVMs that auto-pause when idle and wake on request; sizes are the priced VM sizes. |
| primitive:postgres   | Postgres | verified  | Managed PostgreSQL 16 runs in its own microVM and is auto-provisioned when an app needs a database and no DATABASE_URL is supplied. |

### Prerequisites
1. A Next.js project that builds and starts with the documented commands (next build then next start -H 0.0.0.0 -p $PORT on the node-22 template)
2. A PostgreSQL driver reading DATABASE_URL at runtime (auto-provisioned when omitted, or supplied with --env)
3. An Ample account token with servers:write, databases:read

### Workflow Steps
1. **Build and start**: `next build then next start -H 0.0.0.0 -p $PORT` on the node-22 template. The server must bind 0.0.0.0 on PORT.
2. **Implement the pattern on PostgreSQL**: Copy the approach into your schema; keep migrations idempotent and run them with --release-command.
3. **Deploy**: Run the synchronous deploy once and read the result (exit 0 live, 1 failed, 2 blocked). Re-running with no change is a no-op.
4. **Verify**: Fetch the live URL and the pattern self-test route(s) (/p/relational-records) from the example; then run your own checks. On failure read `ample logs  --kind build` then `--kind runtime`.

### Success Checks
- **App responds on its public URL**
  - Path: `/`
  - Expect: `ample canary next js patterns`
- **Relational-records self-test**
  - Path: `/p/relational-records`
  - Expect: `records=ok transitions=true isolation=true`

### Limitations
1. Verified on the node-22 template at s-1vcpu-1gb with the example fixture; other sizes, templates and Next.js major versions are not verified.
2. The recruiting tracker itself (your record schema, states and access rules) is application code and was not separately tested.
3. Region, compliance attestations and request-duration limits are unknown and not claimed.
4. Apps auto-pause when idle and wake on the next request; always-on is an operator setting, not a plan feature.
5. Managed PostgreSQL 16 only; extensions, connection limits and backup or restore procedures are not verified; apps and their databases are placed together.

### Cost Estimate
- **Currency**: USD
- **Monthly Amount**: $10.00
- **Components**:
  - App server: size s-1vcpu-1gb, monthly amount $5.00
  - Managed PostgreSQL database: size s-1vcpu-1gb, monthly amount $5.00
- **Note**: Always-on monthly price of the tested sizes; apps and databases auto-pause when idle.

### Next Actions
- **Browse the catalog index**: `GET /v1/catalog`
- **Search published recipes by intent, stack and constraints**: `POST /v1/catalog/search`
- **Prepare a side-effect-free deployment plan for an authorized project**: `POST /v1/catalog/plan`
- **Read the existing agent authentication setup**: `GET /mcp/setup`
- **Browse Recruiting tracker**: `GET /v1/catalog/nodes/workload%3Arecruiting-tracker`
- **Browse Next.js**: `GET /v1/catalog/nodes/stack%3Aframework-next-js`
- **Browse Relational records**: `GET /v1/catalog/nodes/pattern%3Arelational-records`
- **Browse Deploy web app**: `GET /v1/catalog/nodes/intent%3Adeploy-web-app`