CoderTurtle

A production-ready Next.js platform with GitHub OAuth, Webhooks, and Prisma.
Built for teams and developers shipping GitHub-integrated products with confidence.

Documentation · Quick Start · Contributing

---

Why CodeTurtle?

A concise, production-ready Next.js starter with GitHub OAuth, webhook handling, and a Prisma-backed database. Designed for developers and teams building GitHub-integrated products.

For detailed architecture, tech stack, project structure, and integration details, see ./docs/README.md.

---

Features (short)

• GitHub OAuth authentication
• Secure GitHub webhook handling
• PostgreSQL + Prisma
• Next.js App Router, Tailwind CSS

---

Getting Started

Prerequisites

• Node.js 18+ or Bun
• PostgreSQL 12+
• GitHub OAuth App

---

Environment Variables

Create a .env file in the project root:

DATABASE_URL="postgresql://user:password@host:port/database"

BETTER_AUTH_SECRET="your-better-auth-secret"
BETTER_AUTH_URL="http://localhost:3000"

NEXT_PUBLIC_APP_URL="http://localhost:3000"

GITHUB_CLIENT_ID="your-github-client-id"
GITHUB_CLIENT_SECRET="your-github-client-secret"

GITHUB_WEBHOOK_SECRET="optional-fallback-secret"

---

Installation

Install dependencies:

bun install

Generate Prisma client and run migrations:

npx prisma generate
npx prisma migrate dev --name init

Optional seed:

bun run db:seed

Start the development server:

bun dev

Open http://localhost:3000 with your browser to see the result.

Database Scripts

• bun run db:clear - Clear all data from database
• bun run db:seed - Clear all data (users are created automatically via GitHub OAuth on first login)
• bun run db:reset - Clear database (runs db:clear and db:seed)

Tech Stack

• Framework: Next.js 15 with App Router
• Language: TypeScript
• Authentication: Better Auth with GitHub OAuth
• Database: PostgreSQL with Prisma ORM
• Styling: Tailwind CSS
• UI Components: Shadcn UI
• State Management: React Query + Zustand
• Runtime: Bun

Learn More

To learn more about Next.js, take a look at the following resources:

• Next.js Documentation - learn about Next.js features and API.
• Learn Next.js - an interactive Next.js tutorial.

You can check out the Next.js GitHub repository - your feedback and contributions are welcome!

Deploy on Vercel

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

Check out our Next.js deployment documentation for more details.

Contributors