Set Up Your Team

Onboarding

Get your team ready to start tracking architectural decisions in Arbtr.

Step 1: Create Your Team

Navigate to the Teams page from the sidebar
Click Create Team
Enter a team name (e.g., "Platform Engineering", "Mobile Team")
Choose a URL slug - this will be your team's permanent URL (e.g., arbtr.io/platform-engineering)
Click Create

tip

Choose a short, memorable slug. It can't be changed after creation, so pick something that will make sense as your team grows.

Go to Team Settings → Members
Click Invite Member
Enter their email address
Select a role:
- Owner: Full control including billing and team deletion
- Admin: Can manage members, settings, and all decisions
- Member: Can create and participate in decisions
Click Send Invite

Invitees receive an email with a link to join. They'll need to create an Arbtr account if they don't have one.

While not required immediately, consider these settings:

Choose which AI provider to use (OpenAI, Gemini, or bring your own key). AI powers Magic Paste, summaries, and insights.

Enable ratification if you need formal approval on concluded decisions. Select an approver (often the CTO or architect).

Connect GitHub, GitLab, or Bitbucket to publish decisions as ADRs. See the integrations guide.

Domains help organize decisions into logical groups. Common examples:

To create domains:

You can always add domains later. Start with 2-4 broad categories and refine as your graph grows.

Your team is now ready. Next steps: