StarterApp Docs

Organizations

Enable multi-member workspaces in StarterApp with a single environment toggle.

StarterApp ships with organizations out of the box. Teams can share a workspace, invite collaborators, and manage billing without writing any extra code—just turn the feature on and follow a few setup steps.

Before you start

  • Autumn billing credentials: Add AUTUMN_SECRET_KEY to your deployment environment so StarterApp can talk to Autumn’s API.
  • Config sync: Whenever you edit autumn.config.ts, run npx atmn push to publish pricing changes.

Once those pieces are in place, the dashboard can manage orgs and billing automatically.

Turn organizations on

Set ORG_MODE=true in your environment (the client flag is derived automatically). Restart your dev server or redeploy.

Sign in. StarterApp creates a personal workspace for every account. This becomes the default organization when you first land in the dashboard.

Open the dashboard sidebar and expand the Organization section to see the switcher and “Create organization” form.

Turn the flag back to false at any time to return to solo mode. Your data is preserved—the UI simply hides the org-specific screens.

Managing members & invitations

  • Use the Organization page in the dashboard to view members, send or cancel invitations, and update roles.
  • Inviting someone who already has an account automatically links their existing login; new users receive the invitation email generated by your auth provider.

Billing

  • Billing runs at the organization level. When teammates share a workspace they automatically share the subscription.
  • Plan changes happen through Autumn’s checkout and billing portal flows. StarterApp reads the customer’s active products directly from Autumn instead of tracking webhooks.

Troubleshooting tips

  • Org UI still hidden? Confirm both ORG_MODE=true and NEXT_PUBLIC_ORG_MODE=true (the latter is populated automatically when you set the server flag).
  • Billing data missing? Verify AUTUMN_SECRET_KEY is set and the dashboard can reach Autumn’s API from your environment.

With these steps, StarterApp delivers a ready-to-use organizations experience—no extra backend work required.