Developer Documentation
Everything you need to build, deploy, and run services on the Tawa platform.
Platform Architecture
How the platform is built, what each service does, how traffic flows, and why they are separate.
Read overviewGetting Started
Install the CLI, create an account, scaffold a project, and deploy your first service in under 5 minutes.
Read guidecatalog-info.yaml Reference
Complete field-by-field reference for configuring databases, routes, dependencies, auth, pod tiers, and more.
View referenceDatabases
How database provisioning works, supported types (MongoDB, Redis, Neo4j), connection strings, naming, and local development.
Learn moreObject Storage
S3-compatible file storage with auto-provisioned buckets, per-deploy credentials, and a zero-config SDK.
Learn moreCredential Rotation
Automatic 30-day credential rotation, zero-downtime redeployment, email notifications, and the compliance dashboard.
Learn moreLogs & Monitoring
Stream pod logs, inspect builds, check service status, and use AI-powered troubleshooting to diagnose issues.
Learn moreGas & Wallets
How gas metering works, token types, spend order, pod tier pricing, and the deploy gate reserve check.
Learn moreEnvironment Variables
How secrets and config vars are managed, encrypted at rest, and injected into your pods on deploy.
Learn moreCustom Domains
Map your own domain to any deployed service with automatic SSL certificate provisioning via Cloudflare.
Learn moreOAuth Integration
Add Bio-ID SSO to your app with the @insureco/bio SDK. PKCE, token exchange, refresh, and userinfo in a few lines of code.
Scheduled Jobs
Declare cron schedules in catalog-info.yaml. iec-cron fires HTTP callbacks to your service on time — no node-cron, no clock drift, no duplicate fires.
Learn moreDocman
Generate PDFs from HTML Handlebars templates or AcroForm forms, store them in S3, and perform merge, split, and page-count operations via the @insureco/docman SDK.
InsureRelay
Send transactional emails and SMS through a single API with Handlebars templates, delivery logging, and gas metering.
View API docsSeptor
Document classification and data extraction for insurance documents using AI-powered analysis.
View guideConfig & Secrets
Manage environment variables and encrypted secrets with the CLI. Auto-injected into pods on every deploy.
Learn moreForgejo & Git
Private Git hosting with auto-deploy webhooks, SSO via Bio-ID, and push-to-deploy workflow.
Learn moreMGA Sample
Scaffold a complete MGA with API, web portal, and reports worker using one command.
View guideCross-Service Scopes
Share database access between services with a request-approve workflow and automatic credential injection.
Learn moreQuick Reference
| Command | Description |
|---|---|
tawa login | Create account or sign in via Bio-id (opens browser) |
tawa whoami | Show current user and org |
tawa sample --static my-site | Scaffold a static HTML/CSS site (nginx) |
tawa sample --api my-svc | Scaffold an Express API project |
tawa sample --nextjs my-app | Scaffold a Next.js application |
tawa sample --mga my-mga | Scaffold a full-stack MGA (API + web + reports) |
tawa preflight | Validate catalog-info.yaml and check readiness |
tawa deploy | Deploy to sandbox (default) |
tawa deploy --prod | Deploy to production |
tawa status | Check deployment status |
tawa logs | Stream container logs |
tawa troubleshoot | AI-powered diagnostics across services |
Platform Services
| Service | URL | Purpose |
|---|---|---|
| Bio-id | bio.tawa.insureco.io | Identity provider — SSO, OAuth2, user management |
| Janus | api.tawa.insureco.io | API gateway — routing, gas metering, auth enforcement |
| Koko | Internal only | Service registry — tracks deployed services and routes |
| Wallet | iec-wallet.tawa.insureco.io | Token wallets — balances, ledger, reserve checks |
| Builder | builder.tawa.insureco.io | Build pipeline — Docker, Helm, K8s deployments |
| Forgejo | git.insureco.io | Git hosting — private repos, mirroring |
| Docman | docman.tawa.insureco.io | Documents — PDF generation, templates, merge, split |
| InsureRelay | relay.tawa.insureco.io | Communications — transactional email and SMS |