NEARBuilders / NEARBuilders/everything-dev
v2-platform: 12 pre-spawned sandbox pool — wildcard DNS/TLS, sleep-on-idle, workshop loop
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 5
- Forks
- 6
- Avg merge
- 1m
- Merged PRs (30d)
- 1
Description
Parent
#274 (v2 platform services spec)
What to build
The pre-spawned sandbox pool: manually deployed machines (Fly or Hetzner — decided by cost/boot profile here) from the sandbox image, behind wildcard DNS + free wildcard TLS (DNS-only CNAME + ACME-challenge delegation to the machine host), mapped to <near-id> subdomains, with sleep-on-idle so idle sandboxes cost ~nothing. No orchestrator, no spawn dashboard — just enough pool for the workshop/demo loop: a wallet-holder deploys, and their sandbox URL updates within seconds. The alchemy program gains the machines + DNS resources (buckets already exist from the storage ticket).
Acceptance criteria
- N sandbox machines run the sandbox image, each serving its account's subdomain over HTTPS
- A deploy + publish from a fresh wallet is live at the account's sandbox URL within seconds
- Idle machines sleep and wake on request without losing state
- Machine + DNS resources are declared in the alchemy program alongside the buckets
- The workshop loop (edit → deploy → refresh → see changes) is demonstrated end-to-end with a non-technical participant
Blocked by
- #285 (sandbox image)
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Read parent issue #274 and blocked issue #285 first, then locate the alchemy program where the existing buckets are declared. Determine the machine provider, wildcard DNS/TLS setup, and sleep/wake flow from the specification. Done means the acceptance criteria pass, including the end-to-end workshop demonstration with a non-technical participant.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- typescript
- Domain
- cloud, devops, infrastructure
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 25/100