Experimentation Lab

A multi-language monorepo for experimenting with conversational tooling, data pipelines, and deployment workflows. The repo combines Next.js frontends, Convex-backed APIs, Go microservices, and Kubernetes/Terraform automation for end-to-end prototyping.

---

Quick Start

1. Prerequisites
   • Node.js 24.11.x and Bun 1.3.5
   • Go 1.24+
   • Docker / Kubernetes tooling if you plan to run services or apply manifests locally
2. Install workspace dependencies

   bun install
   

3. Launch the landing web app

   bun run dev:landing
   

4. Start the Convex backend locally (in another terminal)

   bun run dev:convex
   

5. Run Go services (example)

   go run ./services/prt
   

Prefer a hosted development experience? Click the Open in Coder button above to provision a workspace with Node 24, Bun, and the repository pre-installed.

---

Repository Layout

---

Development Workflows

Frontend

• Lint & format: bun run lint:landing, bun run format
• Build & smoke test: bun run build:landing then bun run start:landing
• Shared Biome config lives at biome.json

Convex Backend

• Generate types: bun run --filter @proompteng/backend codegen
• Start local dev: bun run dev:convex
• Seed models: bun run seed:models

Go Services

• Test all services: go test ./services/...
• Build binaries: go build ./services/...
• Unit test a single service: go test ./services/prt -run TestHandleRoot

Tooling & Quality

• Husky + Biome formatted on commit (lint-staged configuration in package.json).
• Oxlint runs alongside Biome: bun run lint:oxlint for repo-wide JS/TS checks and bun run lint:oxlint:type to run type-aware checks across TS workspaces.
• Type-aware Oxlint uses tsgolint (typescript-go), which may skip unsupported tsconfig options (such as baseUrl)—use lint-only tsconfigs per workspace if needed.
• TailwindCSS v4 & Radix UI used extensively in frontend components.

---

Database Setup

Some experiments expect a Postgres instance (see original Home Cloud notes). To recreate the environment locally:

1. Install the CLI:

   brew install postgresql
   

2. (Linux) install server packages:

   sudo apt update && sudo apt install postgresql
   

3. Enable remote access (optional lab setup):
   • Add to pg_hba.conf:

     host    all    all    192.168.1.0/24    trust
     

   • Ensure postgresql.conf includes listen_addresses = '*'.
4. Create a user & database:

   create role altra with login;
   create database altra with owner altra;
   

5. Grant privileges as needed:

   grant create on database altra to altra;
   

These instructions remain intentionally permissive for an isolated lab network—tighten auth and networking before production use.

---

Infrastructure & Operations

Supporting configuration:

• skaffold.yaml for iterative container builds.
• scripts/generate-* helpers to create sealed secrets and Tailscale auth keys.
• tmp/ contains sample certs, Milvus configs, and operator bundles used during experimentation.

---

Coder Workspace

...