​
New Developer Onboarding

Welcome to FindU! This checklist ensures you have everything needed to start contributing.

​
Pre-Setup Checklist

Complete these items before running the setup script:
1

Request Access

Contact your team lead to get:
  • GitHub organization invite
  • Supabase project access
  • Slack workspace invite
  • Railway team access (if needed)
2

Accept Invitations

Check your email and accept:
  • GitHub organization invitation
  • Supabase project invitations (dev + prod)
  • Slack workspace invitation
  • Any other pending invites
3

Install Prerequisites

# macOS (using Homebrew)
brew install git node python3 supabase/tap/supabase

# Install Docker Desktop
# Download from: https://www.docker.com/products/docker-desktop

# Verify installations
git --version        # Should be 2.30+
node --version       # Should be 18+
python3 --version    # Should be 3.8+
supabase --version   # Latest version
docker --version     # Docker Desktop should be running
For iOS development also install:
  • Xcode from App Store
  • CocoaPods: sudo gem install cocoapods
Make sure Docker Desktop is running before proceeding. You’ll see a whale icon in your menu bar.

​
Environment Setup

Once you have access, set up your development environment:
1

Get Credentials

Ask your team lead for:
  • Development Supabase credentials
  • Production Supabase credentials (view-only)
  • Any API keys needed
Never share these credentials or commit them to Git!
2

Run Setup Script

# Clone dev-tools
git clone https://github.com/findu-app/dev-tools.git

# Run setup from parent directory (NOT from inside dev-tools!)
./dev-tools/scripts/setup.sh
The script will:
  • Clone all repositories
  • Create .env.local template
  • Optionally install dependencies (answer ‘y’ for full setup)
  • Create the findu CLI tool
Full setup with dependencies takes 15-20 minutes. You can skip dependency installation and run it later.
3

Verify Setup

# Check CLI is working
./findu env status

# Should show: Current environment: dev

​
First Day Tasks

Read Documentation

Explore Codebase

  • Browse each repository
  • Understand file structure
  • Read recent PRs

Setup Dev Tools

  • Configure your IDE
  • Install recommended extensions
  • Set up debugging

Join Channels

Slack channel to join:
  • #dev

​
Your First PR

Complete this mini-project to familiarize yourself with our workflow:
1

Find Starter Task

Look for issues labeled good-first-issue or ask your mentor for a suggestion.Good starter tasks:
  • Fix a typo in documentation
  • Add a missing TypeScript type
  • Improve error messaging
  • Add a unit test
2

Create Branch

cd ~/findu/[relevant-repo]
git checkout dev
git pull origin dev
git checkout -b feature/your-first-task
3

Make Changes

  • Write your code
  • Test locally
  • Commit with clear message
4

Open PR

  • Push to GitHub
  • Create PR targeting dev branch
  • Fill out PR template
  • Tag your mentor for review

​
Week 1 Goals

By the end of your first week, you should:
  • Have all tools and access set up
  • Successfully run each component locally
  • Understand the basic architecture
  • Complete your first PR
  • Attend team standup
  • Schedule 1:1 with team lead

​
Getting Help

  1. Check repository CLAUDE.md files
  2. Search Slack history
  3. Ask in #dev
  4. Tag your mentor
Pro tip: Keep this checklist bookmarked and refer back to it during your first few weeks!