Local Setup
This guide walks you through setting up CS-Arena for local development so you can start contributing.
Fork the Repository
Start by forking the repo on GitHub, then clone your fork:
git clone https://github.com/YOUR_USERNAME/CS-Arena.git
cd CS-Arena
Install Dependencies
npm install
Environment Variables
You'll need accounts for the following services:
| Service | Purpose | Free Tier |
|---|---|---|
| Sanity | CMS & database | ✅ Yes |
| GitHub OAuth | Authentication | ✅ Yes |
| Google OAuth | Authentication | ✅ Yes |
| Sentry | Error tracking | ✅ Yes |
Create your .env.local:
NEXT_PUBLIC_SANITY_PROJECT_ID=
NEXT_PUBLIC_SANITY_DATASET=production
SANITY_API_TOKEN=
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=
GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
Run the Dev Server
npm run dev
Sanity Studio
To access the CMS locally:
# Navigate to:
http://localhost:3000/studio
Branch Naming
When working on a feature or fix, create a new branch:
# Feature
git checkout -b feat/your-feature-name
# Bug fix
git checkout -b fix/your-bug-name
Was this page helpful?
Edit this page on GitHub
Last updated: 3/20/2026