Skip to content

nerdynetco/website

Repository files navigation

nerdy network

Ask DeepWiki - Docs

Nerdy Network is a builder-focused social platform for nerds - think GitHub + Twitter + Hogwarts for builders. It's where nerds log their daily progress, compete in house challenges, and build in public together.

What is Nerdy Network?

Nerdy Network transforms the traditional nerds experience into a gamified builder community:

  • Build in Public: Daily progress logging with 365-day GitHub-style heatmaps
  • House System: Hogwarts-inspired houses with weekly competitions and leaderboards
  • Gamification: Streaks, badges, and house points for consistent building
  • Community: Share projects, get feedback, and connect with fellow builders
  • Accountability: Track your builder journey and maintain momentum

Key Features

Build in Public System

  • Daily progress logging with 6 categories (Code, Design, Research, Shipping, Learning, Planning)
  • 365-day activity heatmap visualization
  • Streak tracking (current + longest)
  • Milestone badges (7/30/100 day achievements)
  • Auto-sharing progress to community feed

House System

  • 4 Hogwarts-inspired houses
  • Quiz-based house sorting
  • House-specific feeds and pages
  • Weekly house leaderboard
  • House points for activities

Gamification

  • Upvote/downvote system
  • Quick reactions
  • Achievement badges
  • Progress intensity tracking
  • Weekly top builders

Community Features

  • Create and share posts
  • Comment threading
  • Hot/New/Top sorting
  • Full-text search
  • Category filtering
  • Edit/delete functionality

Moderation

  • Report system (5 report types)
  • Moderator dashboard
  • Content flagging
  • Action tracking
  • Stats visualization

Tech Stack

Frontend

  • Framework: Next.js 15.5.9 (App Router)
  • Language: TypeScript
  • Styling: TailwindCSS
  • UI Components: shadcn/ui
  • State Management: React Server Components
  • Animations: Framer Motion

Backend

  • Database: PostgreSQL (users/auth) + MongoDB (community/content)
  • ORM: Drizzle (PostgreSQL) + Mongoose (MongoDB)
  • Authentication: Better Auth with Google OAuth
  • API: Next.js Server Actions

Infrastructure

  • Monorepo: Turbo Repo
  • Deployment: Vercel (Platform) + Cloudflare (Assets)
  • File Storage: Cloudflare R2

Project Structure

/website
  /apps
    /platform          # Main App (Next.js)
      /app             # App Router pages
      /src
        /actions       # Server actions
        /db            # Database schemas
        /models        # MongoDB models
        /auth          # Authentication
      /@               # Shared components & utils
    /website           # Landing Page
    /mail-server       # Email service
  /docs                # Documentation
  /turbo.json          # Turbo configuration
  /README.md           # This file

Getting Started

Prerequisites

  • Node.js 22.x
  • PostgreSQL database
  • MongoDB database
  • Google OAuth credentials

Installation

  1. Clone the repository
git clone https://github.com/nerdynetco/website.git
cd website
  1. Install dependencies
npm install
  1. Set up environment variables

Create .env in apps/platform/:

# Database
DATABASE_URL="postgresql://..."
MONGODB_URI="mongodb://..."

# Auth
BETTER_AUTH_SECRET="your-secret-key"
BETTER_AUTH_URL="http://localhost:3000"

# Google OAuth
GOOGLE_CLIENT_ID="your-google-client-id"
GOOGLE_CLIENT_SECRET="your-google-client-secret"

# App Config
NEXT_PUBLIC_APP_URL="http://localhost:3000"
  1. Run database migrations
cd apps/platform
npm run db:push
  1. Start development server
npm run dev

Visit http://localhost:3000 to see the app!

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Development Workflow

  1. Create a feature branch from dev
  2. Make your changes
  3. Test thoroughly (npm run build)
  4. Submit a pull request to dev

Code Style

  • TypeScript strict mode
  • ESLint + Prettier
  • Conventional commits
  • Meaningful commit messages

License

This project is open source and available under the MIT License.

Acknowledgments

  • Built with ❤️ by the Nerdy Network team
  • Inspired by GitHub, Twitter, and Hogwarts
  • Powered by the builder community

Contact


Built for builders, by builders.

About

nerdy-network website

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published