Collaboration 1st , code 2nd.

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.

Website • Documentation • Contributing • Substack

---

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)

Contribution Workflow

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))

Loading

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-website

Set up environment variables (optional):

cp .env.example .env

Then add a GitHub personal access token (classic) as both GITHUB_TOKEN and DOCUSAURUS_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 start

Your application will be available at http://localhost:3000

🐳 Prefer Docker? Use this instead

Docker Compose (with hot-reload):

docker-compose up

Plain 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-name

Make 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-name

Submit 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 serve

Note

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.

📚 Documentation

• Contributing Guidelines
• Code of Conduct
• Understanding Lint Checks
• Our Documentation Standards

📊 Project Statistics

👥 Contributors

We appreciate all contributions to recode hive! Thank you to everyone who has helped make this project better.

📬 Stay Connected

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