recode hive is an open-source project where developers learn by collaborating, get paid for technical writing, and gain access to real-world projects and sponsorship opportunities.
Important
Get the recode hive source from recodehive/recode-website or the live site at recodehive.com.
A similar repository name or copied README does not establish that a download is official.
Prerequisites
Node.js 20.9 – 22 (see.nvmrc)
Docker (optional, for containerized development) Docker Compose (optional)
We welcome contributions from developers of all skill levels! Here's how you can get started:
Recode.Hive.Repository.GitHub.mp4
▶ Start Contributing to Open Source with recode hive (Setup Guide)
flowchart LR
Fork[Fork the project]-->branch[Create a New Branch]
branch-->Edit[Edit file]
Edit-->commit[Commit the changes]
commit -->|Finally|creatpr((Create a Pull Request))
Note
Step-by-Step Installation Guide
Fork and clone the repository, then get it running by following Installation.
git clone https://github.com/<your-username>/recode-website.git
cd recode-websiteSet up environment variables (optional):
cp .env.example .envThen add a GitHub personal access token (classic) as both
GITHUB_TOKENandDOCUSAURUS_GIT_TOKEN. It avoids GitHub API rate limits and fills the discussions, releases and sponsors pages with live data.
Warning
How to work with the .env file
The GitHub token is the only value you need for local development, and the site runs without it. Keys for Leaderboard, Algolia search, Clerk sign-in, EmailJS and Supabase are managed by the maintainers, Feel free to create your own GitHub token and put in .env file or if you working on the above function you can request to @sanjay-kv if you need dev key.
Run the site locally (Recommended):
npm install
npm run startYour application will be available at http://localhost:3000
🐳 Prefer Docker? Use this instead
Docker Compose (with hot-reload):
docker-compose upPlain Docker (no hot-reload, rebuild after changes):
docker build -t recodehive-app .
docker run -p 3000:3000 recodehive-app✅ Checklist before pushing new PR
**Create a new branch:**git checkout -b feature/your-feature-nameMake your changes and test thoroughly.
Commit your changes:
git commit -m "Add: brief description of your changes"Push to your fork:
git push origin feature/your-feature-nameSubmit a Pull Request with a detailed description of your changes
Tip
Production Build
The build first fetches releases, sponsors and community PRs from GitHub, so it needs network access. Set the tokens from .env to avoid rate limits.
npm run build
npm run serveNote
Tech Stack
- Framework: Docusaurus 3 (React + TypeScript)
- Language: TypeScript (Node.js 20.9 – 22)
- Styling: Tailwind CSS 4
- UI Components: Radix UI, Framer Motion
- Linting & Formatting: ESLint, Prettier
- Type Checking: TypeScript (
tsc)
📁 Project Structure
| Folder | What lives here | |
|---|---|---|
| ⚙️ | .github/ |
Issue & PR templates, workflows, README assets |
| ✍️ | blog/ |
Blog posts |
| 🤝 | community/ |
Contributing guidelines and community docs |
| 📚 | docs/ |
Main documentation (GitHub, Google Student Ambassador, …) |
| 🎓 | learn/ |
Learning content |
| 🔌 | plugins/ |
Custom Docusaurus plugins |
| 🧰 | scripts/ |
Maintenance and build scripts |
| 🧩 | src/ |
Source code: components, pages, theme, styles, utils |
| 🗄️ | supabase/ |
Supabase configuration |
| 🖼️ | static/ |
Static assets: icons, images |
| 📖 | wiki/ |
Project wiki |
🔍 Expand the src/ folder
| Folder | Purpose |
|---|---|
components/ |
React components |
css/, styles/ |
Global and custom styles |
data/, database/ |
Static data and database helpers |
pages/ |
Site pages |
plugins/, theme/ |
Docusaurus plugins and theme overrides |
services/, lib/, utils/ |
Services, shared libraries and helpers |
Tip
Video Tutorial
New here? Watch this walkthrough of how to set up the project and make your first contribution.
We appreciate all contributions to recode hive! Thank you to everyone who has helped make this project better.
Stay up to date with the latest from recode hive:
Happy open-source contributions, collaboration 1st and code 2nd! 🎉
Made with ❤️ by the recode hive community
