How do I set up DevTrack locally?

[Priyanshu-byte-coder]

Getting started question for anyone who runs into the same thing.

What do I need to run DevTrack locally?

Specifically:

• What env variables are required?
• Do I need a real GitHub OAuth app or can I mock it?
• Is a Supabase project required or is there a local alternative?

Posting this so the answers live somewhere searchable for future contributors.

[IshitaSingh0822]

Great question to document — here's the full breakdown for anyone setting up DevTrack locally:

---

Required Environment Variables

Create a .env.local file in the root and fill in these values:

# GitHub OAuth
GITHUB_CLIENT_ID=your_github_oauth_client_id
GITHUB_CLIENT_SECRET=your_github_oauth_client_secret
NEXTAUTH_SECRET=any_random_string_32chars
NEXTAUTH_URL=http://localhost:3000

# Supabase
NEXT_PUBLIC_SUPABASE_URL=your_supabase_project_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key

Never commit .env.local — it's already in .gitignore.

---

Do you need a real GitHub OAuth app?

Yes, you do — but it's free and takes 2 minutes:

1. Go to GitHub → Settings → Developer Settings → OAuth Apps → New OAuth App
2. Set Homepage URL to http://localhost:3000
3. Set Callback URL to http://localhost:3000/api/auth/callback/github
4. Copy the Client ID and generate a Client Secret

You can't mock GitHub OAuth easily here since DevTrack's entire dashboard depends on your real GitHub data being fetched via the authenticated session.

---

Do you need a real Supabase project?

You have two options:

Option A — Free Supabase cloud project (recommended for beginners)

• Go to supabase.com, create a free project
• Grab Project URL and anon public key from Project Settings → API
• Paste into your .env.local

Option B — Run Supabase locally via CLI

• Requires Docker installed
• Run supabase start in the project root
• Local URLs will be printed in the terminal — use those in your .env.local

Option A is faster for most contributors. Option B is better if you want to test DB schema changes.

---

Full walkthrough is also in DEVELOPMENT.md in the repo. Hope this helps!

[sumitkumar2374]

Great question. It would be helpful if the project documentation included:

A list of all required environment variables with example values.
Whether a real GitHub OAuth app is required or if a mock/test setup is supported.
Whether a Supabase project is mandatory or if a local development alternative is available.
Step-by-step instructions for running the project locally.

Having this information in the README or a setup guide would make onboarding much easier for new contributors.