Overview / Infrastructure
Layer 2 · Proven end to end

The infrastructure
underneath

Every app ClinicIQ generates runs on real cloud infrastructure: Firecracker microVMs, live previews, immutable releases, managed databases, and white-label domains — all on your own cliniciq.com, with zero MIOSA branding in front of your users.

7 compute nodes · healthy Firecracker microVMs *.cliniciq.com white-label

The resource model

What the platform gives every app

Sandbox

Headless Firecracker microVM. The agent writes files, runs the dev server, installs deps — the editable workspace where an app is built.

Preview

A stable live URL on *.sandbox.cliniciq.com returned only after the port is verified reachable. Survives edits and rebuilds.

Release

Publish freezes the approved state into an immutable build artifact with env manifest and provenance — deployable without the live sandbox.

Deployment

Promotes a release to a stable production URL on *.cliniciq.com. Supports rollback and zero/low-downtime promotion.

Managed database

Postgres / MySQL / Redis provisioned on demand, credentials issued, wired into the sandbox and the deployed app at boot.

Storage & cron

S3-compatible buckets with presigned URLs, plus scheduled cron jobs — all surfaced in the Resources module.

The lifecycle

From editable preview to stable production

The same approval flow every modern platform uses — preview where you edit, publish to freeze, deploy to ship — adapted so the user-facing URL stays clean and stable the whole way.

Sandbox
editable source
Primary preview
slug.sandbox.cliniciq.com
Publish
immutable release
Deploy
slug.cliniciq.com

Live edits keep the same preview URL. Production never points at a mutable sandbox. Rollback re-points the deployment to a prior release without rebuilding.

White-label, done right

Three edge layers — all on cliniciq.com

The hard part of white-label isn't the happy path, it's making every layer resolve to the client's domain — including error and loading states. All three now do.

Preview
{slug}.sandbox.cliniciq.com — one clean URL per editable app
Production
{slug}.cliniciq.com — durable deployments, resolved by a single shared backend resolver
Custom domain
client-owned domains via CNAME attach + DNS verification + automatic TLS
Fallback / errors
loading and 502 states render ClinicIQ-safe copy — no MIOSA name, links, or branding

What I hardened to get here

The production fixes (this week)

Getting from "works in a demo" to "works for a real client" meant fixing the failure modes. These are the concrete fixes, shipped and verified across all 7 nodes.

SHIPPED

Tenant deployment domains

Durable deploys now resolve to *.cliniciq.com via one shared backend resolver — not the old hardcoded fallback. Re-registered 151 existing routes through the edge.

SHIPPED

Managed Postgres credentials

Postgres boot now enforces the issued password, fixes ownership, clears inherited PG env, and runs a real login check before reporting healthy — so a DATABASE_URL that's handed out actually authenticates.

SHIPPED

Dynamic deploy reliability

Artifact upload chunked (fixed large-payload failures), runtime memory floor raised to 8GB (fixed OOM exit 137). Dynamic apps now deploy and stay up 24/7.

SHIPPED

Cleaner publish errors

Static publish failures now return a structured 422 with an actionable message instead of a generic 500. CLI URL reporting fixed (no more bad api.miosa.app URLs).

Proof from the test run

Full Postgres E2E, end to end

# ClinicIQ managed-Postgres end-to-end — PASSED
 created managed Postgres
 linked into sandbox at boot (DATABASE_URL authenticates)
 ran migration + query from sandbox
 preview read/write worked
 dynamic publish worked
 deployed app hit the same real DB (read/write)
 cleanup completed

deploy URL: https://ciq-pg-1780311862-24183-app.cliniciq.com