DocsContributingLocal Setup

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:

ServicePurposeFree Tier
SanityCMS & database✅ Yes
GitHub OAuthAuthentication✅ Yes
Google OAuthAuthentication✅ Yes
SentryError 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