Overview

Please follow the guide in the provided order.

This section will guide you through running StudyStudio on your local machine. You will install dependencies, configure environment variables, connect third party services, set up the database, and start the development server.

Getting Started

Install Node.js, pnpm, and clone the repository

Environment Variables

Create your .env.local file with all required keys

Convex Database

Start the Convex development server and schema

Authentication

Configure Better Auth and seed the admin account

Google Gemini

Add your Gemini API key for AI features

Resend

Configure transactional email delivery

Payment Gateways

Add Stripe, PayPal, Razorpay, and Flutterwave keys

Start the Server

Run pnpm dev and open the app in your browser

Setup at a Glance

Install dependencies

Install Node.js v22.14.0 or later and pnpm, then run pnpm install.

Copy the env file

Copy .env.example to .env.local and fill in the keys in later steps.

Start Convex

Run npx convex dev and add the printed NEXT_PUBLIC_CONVEX_URL to .env.local.

Connect services

Add your Google Gemini key, Resend, and payment gateway credentials.

Start the server

Run pnpm dev and open http://localhost:3000 to start studying.