Learn what UtopiaSystem is, which apps exist, and what to read first.
Team Onboarding is a learning section for new team members who are joining the UtopiaSystem project.
This section explains the tools, workflow, access, and daily practices used by the team. It is meant to help new developers understand not only the system, but also how the team works with the system.
This section is split into pages that explain first-time setup, team workflow, access, tools, deployments, daily work, and troubleshooting.
Learn what UtopiaSystem is, which apps exist, and what to read first.
Understand tasks, branches, pull requests, reviews, merges, and releases.
Track the accounts a new team member needs before working independently.
Use practical guides for running apps, checking logs, builds, and deployments.
The purpose of Team Onboarding is to help new team members become productive faster.
Each page focuses on a different layer of joining and working with the project.
The Getting Started page explains what a new team member should do first.
Use this page as the first stop for a new developer.
The Team Workflow page explains how the team works day to day.
Use this page to understand the team's development rhythm.
The GitHub Guide explains how the team uses GitHub.
Use this page when working with branches, commits, and pull requests.
The Local Development Tools page explains the tools needed for day-to-day development.
Use this page when preparing a new laptop or development environment.
Use these pages when work touches project infrastructure, authentication, deployments, or environment configuration.
The Supabase Guide explains how Supabase is used in UtopiaSystem.
Use this page when working with authentication, database, storage, or policies.
The DigitalOcean Guide explains how DigitalOcean is used by the team.
Use this page when working with backend deployment or DigitalOcean-hosted services.
The Google Cloud Guide explains how Google Cloud is used in the project.
Use this page when working with Google login or Google-related integrations.
The Vercel Guide explains how frontend apps are deployed.
Use this page when checking frontend deployment status or updating frontend environment variables.
The Accounts & Access page explains which accounts a new team member may need.
| Tool | Why It Is Needed |
|---|---|
| GitHub | Repository access and pull requests |
| Supabase | Database, Auth, Storage, and Policies |
| Vercel | Frontend deployment and environment variables |
| DigitalOcean | Backend deployment and registry access |
| Google Cloud | OAuth and Google sign-in configuration |
| Wiki.js | Reading and updating documentation |
Use this page to track what access a new team member needs before they can work independently.
These pages help new developers handle common work and unblock simple issues.
The Common Daily Tasks page explains common actions developers perform regularly.
Use this page as a practical "how do I do this?" guide.
The Troubleshooting Basics page explains common problems and how to investigate them.
Use this page when a new developer gets stuck.
The Glossary page explains common terms used in the project.
Use this page when a new team member sees unfamiliar terms in the documentation or codebase.
Nx
Supabase
RLS
SSO
JWT
Vercel
PM2
Migration
Service Role Key
Anon Key
Pull Request
Development Branch
Production
Edge Function
A new team member can follow this order. The remaining pages can be read when the related tool is needed.
Team Onboarding is the parent section for new team member learning material. It explains how to get started, which tools are used, how the team works, and where to find practical guides for daily development tasks.