# Orbits > Orbits hosts web apps: connect a GitHub, GitLab or Bitbucket repository, or upload a folder, and get a live URL at .theorbits.app, with previews for every branch and pull request, custom domains, environment variables, runtime logs, analytics, Speed Insights, feature flags, workflows and alerts. Apps run in Abuja, Nigeria. Plans: Free, and Pro at $5 a month, paid in Naira. Its API is at https://api.theorbits.app/v1 and takes a team API token (Authorization: Bearer orb_live_…). The API's OpenAPI 3.1 contract: https://docs.orbits.africa/openapi/orbits-api.yaml (JSON: https://docs.orbits.africa/openapi/orbits-api.json); collections of it for Postman (https://docs.orbits.africa/postman/orbits-api.postman_collection.json), Insomnia (https://docs.orbits.africa/insomnia/orbits-api.insomnia.json) and Bruno (https://docs.orbits.africa/bruno/orbits-api.bruno.zip). Errors are RFC 9457 problem documents; lists use limit and cursor; slow changes answer 202. Agents: read https://docs.orbits.africa/agent-brief.md first, and "Using the API from an AI agent" before acting on anyone's apps. MCP clients can connect to the hosted MCP server at https://mcp.theorbits.app/mcp (https://docs.orbits.africa/ai/connect-your-ai; tools: https://docs.orbits.africa/ai/mcp-tools). CLI: orbits (https://docs.orbits.africa/cli). SDKs: JavaScript @useorbits/sdk, Python useorbits, Go (https://docs.orbits.africa/sdks). In-app packages: @useorbits/analytics, @useorbits/speed-insights, @useorbits/flags, @useorbits/workflows. ## API reference - [API reference](https://docs.orbits.africa/api): The Orbits REST API, for scripts, CI and your own tools. Everything an API token can do, with examples in cURL and the JavaScript, Python and Go SDKs. - [Authentication](https://docs.orbits.africa/api/authentication): Send a team API token as a bearer token. What full and read tokens may do, project-limited tokens, and the few things no token can do. - [Conventions](https://docs.orbits.africa/api/conventions): Paths, ids, JSON, timestamps, Idempotency-Key, pagination, and how slow changes answer. - [Errors](https://docs.orbits.africa/api/errors): Every error is an RFC 9457 problem document with a request id. What each status means, the 422 field list, and the 402 plan answer. - [Rate limits](https://docs.orbits.africa/api/rate-limits): Limits per person, per API token and per team, the RateLimit headers on every answer, and what to do on a 429. - [Examples](https://docs.orbits.africa/api/examples): Whole jobs with the API, step by step in cURL: deploy and wait, roll back, set a variable and redeploy, add a domain, and deploy a folder. - [OpenAPI and collections](https://docs.orbits.africa/api/postman-openapi): Download the API's OpenAPI 3.1 contract, or the same requests ready to run in Postman, Insomnia or Bruno. - [Using the API from an AI agent](https://docs.orbits.africa/api/ai-agents): Connect an AI app through MCP, build an agent on the SDKs, or give any agent one link, a token limited to what it should do, and the rules that keep it from doing harm. - [Projects](https://docs.orbits.africa/api/projects): Create, read, change, pause and delete projects, and list the starter templates. - [Deployments](https://docs.orbits.africa/api/deployments): Start, follow, promote, roll back, redeploy and cancel deployments, upload source, and read build logs. - [Environment variables](https://docs.orbits.africa/api/environment-variables): A project's variables per environment: list, add, change, delete and restore them, reveal one, or pull them all. - [Domains](https://docs.orbits.africa/api/domains): Add custom domains to a team, attach them to projects, check their DNS, and list a project's branch addresses. - [DNS](https://docs.orbits.africa/api/dns): Records of a domain on Orbits DNS, zone file imports, and email records. - [Runtime logs and observability](https://docs.orbits.africa/api/logs): What a project's apps print and the requests they serve, and the totals behind the Observability page. - [Analytics and Speed Insights](https://docs.orbits.africa/api/insights): Read a project's visitors and Web Vitals, and turn collection on or off. - [Alerts](https://docs.orbits.africa/api/alerts): Alert rules on a project's metrics, their history, and the team's alert channels. - [Feature flags](https://docs.orbits.africa/api/flags): Create and change a project's feature flags, their environments and targeting rules. - [Workflows](https://docs.orbits.africa/api/workflows): The workflows a project's app defines, and their runs: start, read, cancel and retry. - [Sandboxes](https://docs.orbits.africa/api/sandboxes): Short-lived development machines for a project, with a terminal and a team-only preview address. Pro plan. - [Teams and account](https://docs.orbits.africa/api/teams): Who a token acts as, the teams it reaches, a team's settings, overview and notifications. - [Integrations](https://docs.orbits.africa/api/integrations): The team's integrations and whether each is connected. - [Billing](https://docs.orbits.africa/api/billing): The plans, the team's plan and what it includes, and its invoices. - [Usage, activity and operations](https://docs.orbits.africa/api/usage-and-activity): What a team used, its activity feed, and the operations slow changes return. ## Guides - [Deploy your first project](https://docs.orbits.africa/getting-started/quickstart): From a new account to a live site in a few minutes. You sign up, connect GitHub, GitLab or Bitbucket, import a repository and deploy it to its own address on theorbits.app. - [Deploy a folder without Git](https://docs.orbits.africa/getting-started/upload-a-folder): Deploy a project that has no repository by sending its folder as a zip. Orbits builds it like any other deployment and keeps the last five uploads for redeploys. - [How Orbits fits together](https://docs.orbits.africa/getting-started/concepts): Teams, members and roles, projects, deployments, environments, domains and operations, and the IDs that name them. - [Where your apps run](https://docs.orbits.africa/getting-started/region): Orbits has one region, Abuja in Nigeria (abj-1). Every build and every app runs there. - [Deploy from Git](https://docs.orbits.africa/deploy/git): Connect GitHub, GitLab.com or Bitbucket Cloud to a team, deploy on every push, get previews for pull requests, and see each build's status on the commit. - [Frameworks and workloads](https://docs.orbits.africa/deploy/frameworks): Which frameworks Orbits detects, the commands it uses for each, and how each kind of project runs, from static sites to Node servers, workers and containers. - [Build settings](https://docs.orbits.africa/deploy/build-settings): The install, build and output settings, the root directory, the Node.js version, skipping builds with an ignored build step, the build cache, and the warnings a deployment can carry. - [Deployments](https://docs.orbits.africa/deploy/deployments): What starts a deployment, its states and build steps, build logs, deployment addresses, and how to promote, roll back, redeploy and cancel. - [Preview deployments](https://docs.orbits.africa/deploy/previews): Every branch you push gets a preview with its own address. Branch addresses follow a branch's newest preview, and you choose who can open previews. - [Environment variables](https://docs.orbits.africa/deploy/environment-variables): Set keys and secrets per environment, mark them sensitive, reveal, import a .env file, delete with undo, pull them for local development, and redeploy to apply a change. - [Project settings](https://docs.orbits.africa/deploy/projects): Rename a project, pause and resume it, move it to another team, delete it, and what its workload and region mean. - [Domains](https://docs.orbits.africa/domains/overview): Every project's free theorbits.app address, the custom domains your team adds, what a domain can serve, and where to manage them. - [Add a custom domain](https://docs.orbits.africa/domains/custom-domains): Point a domain you own at a project with one DNS record or with Orbits DNS. Orbits verifies it, issues and renews its certificate, and tells you when something needs attention. - [Use Orbits DNS](https://docs.orbits.africa/domains/orbits-dns): Hand a domain's DNS to Orbits by pointing its nameservers at ns1 and ns2.theorbits.app, then manage its records, import a zone file and set up email here. - [Email records](https://docs.orbits.africa/domains/email-records): On a domain that uses Orbits DNS, Email setup adds the MX and SPF records for Google Workspace, Microsoft 365 or Zoho Mail in one step. - [Runtime logs](https://docs.orbits.africa/observe/runtime-logs): Every request your app was sent and every line it printed while running, kept for 7 days. Search and filter them on the project's Logs page, from the CLI or through the API. - [Observability](https://docs.orbits.africa/observe/observability): Production's traffic at a glance. Requests, server errors and response times over time, the busiest routes, status codes and regions, worked out from your project's runtime logs. - [Analytics](https://docs.orbits.africa/observe/analytics): Visitors, top pages, referrers, devices and your own custom events, counted without cookies and without storing IP addresses. Add `@useorbits/analytics` to your app and turn Analytics on for the project. Pro plan. - [Speed Insights](https://docs.orbits.africa/observe/speed-insights): Core Web Vitals from real visits to your production site, on your visitors' own phones and networks, with the slowest routes and the elements behind them. Add `@useorbits/speed-insights` and turn it on for the project. Pro plan. - [Alerts](https://docs.orbits.africa/observe/alerts): Be told when production's error rate or response times cross a line you choose, or when its traffic stops. Rules are checked every minute, and fired and resolved notices go by email or to your team's signed webhook. - [Feature flags](https://docs.orbits.africa/features/flags): Ship code switched off, then turn it on for your team, a share of visitors or everyone, per environment, without a redeploy. Flags live in your project's Flags tab and your app checks them with `@useorbits/flags`. - [Workflows](https://docs.orbits.africa/features/workflows): Durable workflows in your own code with `@useorbits/workflows`. Steps that save their results, retry on failure, survive crashes and deploys, sleep for days or wait for an event, with every run on the project's Workflows tab. - [Sandboxes](https://docs.orbits.africa/features/sandboxes): Short-lived development machines for a project, with a terminal in the browser and a preview address your team can open. Part of the Pro plan. - [Teams and roles](https://docs.orbits.africa/team/teams-and-roles): A team owns projects, domains, integrations and the plan. Create one, invite people as owners, admins, members or viewers, see who is active, and remove people or leave. Owners can delete the team. - [API tokens](https://docs.orbits.africa/team/api-tokens): Tokens let the CLI, CI and your own scripts act on a team without a browser. Make one under Team › Settings › API tokens, choose full or read-only access and an expiry, limit it to one project if you like, and copy the secret, which is shown once. - [Notifications](https://docs.orbits.africa/team/notifications): Choose which events reach your team by email and Slack, see what needs you in the bell, and get a weekly summary every Monday. Microsoft Teams and webhooks pick their own events. - [Integrations](https://docs.orbits.africa/team/integrations): Post deploy, domain and member events to Slack or a Microsoft Teams channel, or send them to your own endpoint as signed webhooks. One place, Team › Integrations, for every tool your team connects. - [Two-factor and team security](https://docs.orbits.africa/team/security): Protect your account with an authenticator app and ten one-time recovery codes. Owners and admins can require two-factor for the whole team, limit how members sign in, sign them out after a set time and choose who can invite. - [Activity](https://docs.orbits.africa/team/activity): Who changed what across the team, one sentence a line, kept for 90 days. Filter it by person, project and kind, search it, and export it as CSV. - [Plans](https://docs.orbits.africa/billing/plans): Orbits has two plans per team. Free hosts unlimited projects. Pro, at $5 a month paid in Naira, adds server functions, Analytics and Speed Insights. What each includes, what happens when Pro ends, and the plan_required error. - [Paying for Pro](https://docs.orbits.africa/billing/paying): Pro is $5 a month, charged in Naira through Flutterwave's hosted page by card or bank transfer. How the Naira price is set, how monthly renewal and the 7-day grace period work, cancelling and resuming, invoices and the emails owners get. - [Usage](https://docs.orbits.africa/billing/usage): What your team and each project used this month, day by day. Requests, bandwidth, build minutes, function runs, deployments and log lines, compared with the month before, with a CSV export. - [Limits](https://docs.orbits.africa/billing/limits): Every fixed limit in Orbits in one place. Upload sizes, how long logs and activity are kept, API rate limits, token and variable counts, and the limits of alerts, flags, workflows and Analytics. - [Connect your AI app to Orbits](https://docs.orbits.africa/ai/connect-your-ai): Let Claude, ChatGPT, Cursor, VS Code and other AI apps deploy and look after your Orbits projects, with one link and your approval. - [What your AI app can do](https://docs.orbits.africa/ai/mcp-tools): Every tool the Orbits MCP server gives your AI app, the access each one needs, and which ones ask before they change production, DNS or delete. - [AI apps and security](https://docs.orbits.africa/ai/ai-apps-security): What a connected AI app can and cannot do, how two-step confirmations work, how to limit an app and disconnect it, and what the Orbits MCP server never shows. - [Troubleshooting AI apps](https://docs.orbits.africa/ai/troubleshooting): Fixes for the problems people hit most when connecting an AI app to Orbits. - [SDKs](https://docs.orbits.africa/sdks): Official Orbits libraries for JavaScript and TypeScript, Python and Go. They handle the token, retries, idempotency, pagination, uploads and waiting for you. - [JavaScript and TypeScript SDK](https://docs.orbits.africa/sdks/javascript): Install @useorbits/sdk, create a client, deploy and follow a build, manage variables and domains, and handle errors, pages and retries. - [Python SDK](https://docs.orbits.africa/sdks/python): Install useorbits, create a client, deploy and follow a build, manage variables and domains, and handle errors, pages and retries, sync or async. - [Go SDK](https://docs.orbits.africa/sdks/go): Install orbits-go, create a client, deploy and follow a build, manage variables and domains, and handle errors, pages and retries. - [Getting help](https://docs.orbits.africa/help/support): Where to look when something isn't working, how to check whether Orbits itself is having a problem, and how to contact the team behind Orbits. - [Security and privacy](https://docs.orbits.africa/help/security-and-privacy): Where your apps and data live, how builds and apps are kept apart, how secrets, tokens and payments are protected, and what Orbits keeps about your visitors. ## Optional - [Everything above in one file](https://docs.orbits.africa/llms-full.txt)