# Appbase

> Lightweight analytics for consumer mobile apps: onboarding, paywall views and meaningful retention. Private customer workspaces, React Native and native Swift SDKs, Fastify and InsForge Auth/PostgreSQL.

## Integration

- [Agent setup](https://appbase.so/docs/agent-setup.md): Create an owned app through the API with a revocable setup prompt, save environment keys, integrate the SDK and verify delivery. Start here when a customer gives you apb_setup_ access.
- [Start here](/docs/quickstart.md): Register an app, install the SDK, track events and verify delivery.
- [React Native SDK 0.2.1](/docs/sdk.md): Install @appbasehq/react-native@0.2.1 from npm; initialization, native adapters, identity and delivery controls.
- [Swift SDK 0.1.0](/docs/swift-sdk.md): Install AppbaseAnalytics 0.1.0 with Swift Package Manager from https://github.com/appbasehq/appbase-swift; iOS lifecycle, durable delivery and workflows.
- [SDK compatibility](/docs/sdk-compatibility.md): Shared behaviors, platform differences and release policy.
- [Tracking plan](/docs/tracking-plan.md): Required properties and exact metric definitions.
- [Feedback / Contact us](/docs/feedback.md): Optional native form, direct submission, retries and private inbox.
- [HTTP API](/docs/api.md): Collection, app creation, setup status, key replacement and reports.
- [InsForge accounts and backend](/docs/insforge.md): Authentication, ownership, cloud/local setup and migration rules.
- [Architecture](/docs/architecture.md): Components, persistence and access boundaries.
- [New business](/docs/new-business.md): Current UI, trial outcomes and the integration plan.
- [Revenue](/docs/revenue.md): All-customer transaction revenue, renewals, refunds, product breakdowns and subscription-state coverage.
- [Paywalls](/docs/paywalls.md): Link onboarding presentations, compare in-app paywalls, inspect optional offers and match verified trials/payments and follow trial outcomes.
- [RevenueCat setup](/docs/revenuecat-setup.md): App identity bridge, backend mapping, provider dashboard webhook and purchase verification.
- [RevenueCat design](/docs/revenuecat.md): Webhook inbox, identity matching, observed billing and remaining reconciliation work.

## Owner setup

Open https://appbase.so and copy the prompt from the empty dashboard, or open Create app. The agent creates the app through the API. Manual creation opens its empty dashboard with a prompt scoped to that app; App setup also exposes saved SDK configuration for manual integration. Setup tokens have no expiration, are revocable and cannot read reports or billing secrets. Existing apps have /apps/APP_ID/setup. InsForge mode uses passwordless email-code signup/sign-in, including locally. Only the separate legacy local lab skips login in development. Docs are public; production credentials and app data require authentication. Never give mobile clients the reporting token or dashboard session.

## Current scope

InsForge account/database service with Fly web/API and a separately tested native iOS Expo lab. React Native 0.2.1 is published on npm as @appbasehq/react-native; this dashboard also preserves versioned HTTPS release archives. Swift 0.1.0 is available through Swift Package Manager from https://github.com/appbasehq/appbase-swift. App setup provides installation, keys, delivery checks and self-service encrypted RevenueCat credentials. RevenueCat Test Store direct purchases and trial conversion feed observed new-business reports. Hosted native tracking, feedback, Test Store purchases and trial conversion are verified. Provider history sync is partial. Apple/Google sandbox verification, Android runtime, physical-device verification and App Store Connect remain future work.