Docs version 1.0.0

Getting Started

Foundation docs that explain the platform architecture, onboarding flow, and how to deploy your first tenant app.

Forge CLI

Command reference, automation workflows, and provider integrations for the Forge CLI surface.

Forge API

HTTP API endpoints, authentication, and usage examples for automating projects outside the CLI.

SDK & Packages

Client libraries, hooks, and configuration helpers that power generated apps and the dashboard.

Integration Guides

How App Factory integrates with Supabase, Stripe, Vercel, domains, analytics, and legacy mobile tooling.

Operations & Compliance

Runbooks, infrastructure playbooks, security posture, audits, and the continuously updated changelog.

🔍⌘K

Start typing to search docs.

SDK Overview

1.0.0

Orientation to shared packages and how generated apps consume them.

On this page

Shared packages
Quick import cheat sheet

Shared packages

The common/ workspace exposes libraries that unify config, auth, payments, analytics, and UI across the dashboard and generated apps.

Package	Purpose
`@app-factory/config`	Loads `ops/apps.yaml`, resolves secrets, emits `.env.generated` files.
`@app-factory/forgeapps-sdk`	Supabase helpers and hooks for tenant-aware data access.
`@app-factory/payments`	Stripe billing flows, webhooks, and customer portal helpers.
`@app-factory/ui`	Shared UI primitives with React + React Native parity.

Info

All packages ship TypeScript types and runtime validation. Rebuild them (pnpm --filter <package> build) whenever you change shared code.

Quick import cheat sheet

import { loadAppsConfig } from '@app-factory/config';
import { useSupabaseClient } from '@app-factory/forgeapps-sdk/web';
import { createCheckoutSession } from '@app-factory/payments/stripe';
import { Button } from '@app-factory/ui';

Continue digging into the package-specific pages below.