founden (TypeScript SDK)

Build and run your company from your own code with one API key. Founden builds the full product (website, app, admin) in the cloud and returns a live link.

Install

npm install founden

Usage

import { Founden } from "founden";

const client = new Founden("omk_your_key_here");

// Start a build
const build = await client.build("Build a booking site for my dental clinic with online payments");
const id = build.data!.execution_id as string;

// Stream live progress (events: build_step, build_complete, build_done, orphaned_build, build_error)
for await (const ev of client.stream(id)) {
  console.log(ev.event, ev.data);
}

// Check status / preview URL
const status = await client.status(id);
console.log(status.data?.preview_url);

// Send a follow-up instruction (free within a build)
await client.message(id, "Add a contact form on the homepage");

// Stop a running build
await client.stop(id);

Methods

| Method | Endpoint | Description | |--------|----------|-------------| | build(prompt, opts?) | POST /v1/builds | Start a build (opts.company_id to target an existing company). 1 credit. | | status(executionId, opts?) | GET /v1/builds/{id} | Status + live preview URL. | | message(executionId, prompt, opts?) | POST /v1/builds/{id}/message | Follow-up instruction. Free within a build. | | stop(executionId, opts?) | POST /v1/builds/{id}/stop | Stop a running build. | | stream(executionId) | GET /v1/builds/{id}/stream | Async generator of SSE build events. |

Every call returns a FoundenResult (success, data, error, metadata, credits_used). One omk_ key works across every O-mega product. Get yours at https://founden.ai/app/build.

License

MIT