The platform built for CS developers to submit graduation projects, find open-source contributors, and get discovered by top tech recruiters.
- Submit graduation projects, Hackathon entries, and personal builds
- Rich Markdown editor for detailed project descriptions
- 3-level cascading classification by Domain → Specialization → Tech Stack
- Full Light / Dark Mode support
- View tracking with cookie-based spam prevention
- Share your profile with a single click via ShareProfileButton
- Advanced search with Cascading Filters (University → Domain → Tech)
- Sort by latest, most upvoted, or most viewed
- Dedicated
/projectslisting page with full filter support
- Apply to join any open-source project directly from the platform
- Full Join Request system with automatic email notifications via Resend
- Accept / Reject requests with optional rejection reason sent to the applicant
- Contributors list displayed on project detail pages
- Global ranking with a stunning 3D Podium UI
- Filter by global or by university
- Ranked by total Upvotes
- Browse developer profiles with real-time GitHub stats
- Dynamic filters to find the right collaborator
- Recruitment cards with a Radar UI design
- Overview stats for your projects (views, upvotes, requests)
- Manage your projects with optimistic deletion
- Handle incoming join requests with accept / reject actions
- Full profile settings with instant session sync
- Full support for Arabic and English
- Automatic RTL layout switching for Arabic
- Complete translation coverage across all pages and components
- Sign in with GitHub OAuth or Google OAuth
- Secure Onboarding flow with middleware protection
- Rate Limiting on all API routes
- Comprehensive HTTP Security Headers
- Route protection via Middleware
- Full Sentry integration for Error Tracking and Session Replay
- Built-in Feedback Widget for user bug reports
- PWA Support — installable on mobile devices
- Auto-generated Sitemap for Google Search Console
- Suspense Streaming for instant page loads
- Prefetching on all static and dynamic navigation links
- Full MDX-powered Docs with search
- Bilingual docs (Arabic & English) with automatic locale detection
- Interactive sidebar with GitHub edit links
- Last updated timestamps and frontmatter support
- Dedicated page showcasing open-source projects
- Real-time GitHub stats per project
- Contributors section per project
- Cosmic timeline UI for platform update history
- Full multilingual support
| Technology | Version | Usage |
|---|---|---|
| Next.js | 16.x | App Router, Server Components, Streaming |
| React | 19.x | UI Framework |
| TypeScript | 5.x | Type Safety |
| Tailwind CSS | 3.x | Styling |
| Sanity CMS | 3.x | Database & Content Management |
| NextAuth.js | 5.x Beta | Authentication |
| Framer Motion | 12.x | Animations |
| next-intl | 4.x | Internationalization (i18n) |
| Sentry | 10.x | Error Tracking & Session Replay |
| Resend | 6.x | Transactional Emails |
| Zod | — | Schema Validation |
| shadcn/ui | — | UI Components |
| Vercel | — | Deployment |
CS-Arena/
├── app/
│ ├── (root)/
│ │ ├── about/
│ │ ├── blog/
│ │ ├── coming-soon/
│ │ ├── cookies/
│ │ ├── dashboard/
│ │ ├── developers/
│ │ ├── docs/
│ │ │ └── [...slug]/
│ │ ├── leaderboard/
│ │ ├── onboarding/
│ │ ├── open-source/
│ │ ├── privacy/
│ │ ├── project/
│ │ │ ├── [id]/
│ │ │ │ └── edit/
│ │ │ └── create/
│ │ ├── projects/
│ │ ├── terms/
│ │ ├── user/[id]/
│ │ ├── layout.tsx
│ │ └── page.tsx
│ ├── api/
│ │ └── docs-search/
│ ├── studio/[[...tool]]/
│ ├── global-error.tsx
│ ├── layout.tsx
│ ├── not-found.tsx
│ └── sitemap.ts
├── components/
│ ├── dashboard/
│ │ ├── ManageProjects.tsx
│ │ ├── ProfileSettings.tsx
│ │ └── ProjectRequests.tsx
│ ├── docs/
│ │ ├── DocsFeedback.tsx
│ │ └── DocsSidebar.tsx
│ ├── layout/
│ │ ├── Footer.tsx
│ │ └── Navbar.tsx
│ ├── project/
│ │ ├── ContributorsSection.tsx
│ │ ├── EditProjectForm.tsx
│ │ ├── ProjectCard.tsx
│ │ ├── ProjectFilters.tsx
│ │ ├── ProjectForm.tsx
│ │ ├── TeamFilters.tsx
│ │ ├── UpvoteButton.tsx
│ │ └── UserProjects.tsx
│ ├── shadcn/
│ │ ├── avatar.tsx
│ │ ├── button.tsx
│ │ ├── input.tsx
│ │ ├── skeleton.tsx
│ │ ├── textarea.tsx
│ │ ├── toast.tsx
│ │ └── toaster.tsx
│ └── shared/
│ ├── CustomFilterSelect.tsx
│ ├── FeedbackButton.tsx
│ ├── GithubStats.tsx
│ ├── HeroSection.tsx
│ ├── JoinTeamButton.tsx
│ ├── LanguageToggle.tsx
│ ├── MobileMenu.tsx
│ ├── OnboardingForm.tsx
│ ├── Ping.tsx
│ ├── PolicySections.tsx
│ ├── ProjectsGrid.tsx
│ ├── Providers.tsx
│ ├── SearchForm.tsx
│ ├── SearchFormReset.tsx
│ ├── ShareProfileButton.tsx
│ ├── TechFilters.tsx
│ ├── ThemeToggle.tsx
│ ├── View.tsx
│ └── ViewTracker.tsx
├── config/
│ └── docs.ts
├── constants/
│ └── ecosystem.ts
├── content/
│ └── docs/
│ ├── contributing/
│ │ ├── guidelines.ar.mdx
│ │ ├── guidelines.en.mdx
│ │ ├── setup.ar.mdx
│ │ └── setup.en.mdx
│ ├── getting-started/
│ │ ├── introduction.ar.mdx
│ │ ├── introduction.en.mdx
│ │ ├── quick-start.ar.mdx
│ │ └── quick-start.en.mdx
│ └── user-guide/
│ ├── find-developers.ar.mdx
│ ├── find-developers.en.mdx
│ ├── projects.ar.mdx
│ └── projects.en.mdx
├── hooks/
│ └── use-toast.ts
├── i18n/
│ └── request.ts
├── lib/
│ ├── actions.ts
│ ├── docs.ts
│ └── utils.ts
├── messages/
│ ├── ar.json
│ └── en.json
├── public/
│ ├── cs-arena-logo.png
│ ├── cs-arena-logo-192.png
│ ├── cs-arena-logo-512.png
│ └── manifest.json
├── sanity/
│ ├── lib/
│ │ ├── client.ts
│ │ ├── live.ts
│ │ ├── queries.ts
│ │ └── write-client.ts
│ └── schemaTypes/
│ ├── author.ts
│ ├── changelog.ts
│ ├── domain.ts
│ ├── index.ts
│ ├── joinRequest.ts
│ ├── project.ts
│ └── university.ts
├── auth.ts
├── middleware.ts
├── instrumentation.ts
├── sentry.client.config.ts
├── sentry.edge.config.ts
├── sentry.server.config.ts
├── next.config.ts
├── tailwind.config.ts
└── tsconfig.json
| Route | Description |
|---|---|
/ |
Home — search and discover projects |
/project/create |
Submit a new project |
/project/[id] |
Project details |
/project/[id]/edit |
Edit your project |
/projects |
All projects listing |
/leaderboard |
Top projects with 3D Podium UI |
/open-source |
Hall of Fame for open-source projects |
/developers |
Browse developer profiles |
/user/[id] |
Developer public profile |
/dashboard |
User dashboard & settings |
/onboarding |
New user setup flow |
/docs |
Full documentation system (MDX) |
/docs/[...slug] |
Individual documentation pages |
/changelog |
Platform update history |
/about |
About CS Arena |
/privacy |
Privacy policy |
/terms |
Terms of service |
/cookies |
Cookie policy |
/blog |
Blog (coming soon) |
/studio |
Sanity CMS dashboard |
- Node.js 18+
- npm 10+
- Sanity account
- GitHub OAuth App
- Google OAuth App
# 1. Clone the repository
git clone https://github.com/Ali-Haggag7/CS-Arena.git
cd CS-Arena
# 2. Install dependencies
npm install
# 3. Set up environment variables
cp .env.example .env.local# Auth
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=your_secret
# GitHub OAuth
AUTH_GITHUB_ID=your_github_client_id
AUTH_GITHUB_SECRET=your_github_client_secret
# Google OAuth
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
# Sanity CMS
NEXT_PUBLIC_SANITY_PROJECT_ID=your_project_id
NEXT_PUBLIC_SANITY_DATASET=production
SANITY_WRITE_TOKEN=your_write_token
# Sentry
SENTRY_AUTH_TOKEN=your_sentry_token
# Resend (Email)
RESEND_API_KEY=your_resend_key
# App
NEXT_PUBLIC_BASE_URL=http://localhost:3000# 4. Start the development server
npm run devOpen http://localhost:3000 in your browser.
Access the CMS dashboard locally at:
http://localhost:3000/studio
Contributions are welcome! Please read the Contributing Guidelines before getting started.
# Create a new branch
git checkout -b feat/your-feature-name
# After making your changes
git commit -m "feat: add your feature"
git push origin feat/your-feature-nameLook for issues tagged good first issue — that's the best place to start!
MIT License — feel free to use and modify.
