study toolkit for students

a minimal, open-source study platform with focused productivity tools and ai-powered agents — built by a student, for students.

---

what this platform does

the platform is split into personal tools (persistent, tied to your daily workflow) and disposable tools (on-demand ai utilities).

personal tools

these are meant to be used every day and stored for long-term tracking.

• daily logs
  write and track daily work, learnings, and reflections.

• daily checklist
  manage todos with priority and completion tracking.

• study heatmap
  visualize consistency and streaks using a github contribution-style heatmap.

disposable ai tools

these tools don’t store long-term state and are focused on quick outcomes.

• flashcards agent
  automatically generates study flashcards from input content.

• chat with pdf agent
  upload a pdf and have contextual conversations with it.

• summarizer
  condenses long text or documents into concise summaries.

• web search tool
  searches and retrieves relevant research papers and sources.

---

key features

• credit-based ai usage
  get started instantly with 300 free credits. no need to set up api keys or navigate complex dashboards.

• intelligent token management
  different tools cost different credits based on their complexity and output length (e.g., chat with reasoning vs. flashcards).

• future-proof fallback once credits are exhausted, the platform is designed to allow users to plug in their own Gemini API key to continue usage.

• server actions + react server components
  used for optimized, secure data mutations and rendering.

• clean, distraction-free ui
  focused on usability, not gimmicks.

• open source
  transparent codebase, easy to extend.

• built by a student, for students
  opinionated toward real study workflows, not generic “ai dashboards”.

---

tech stack

• next.js (app router) — frontend + server rendering
• vercel ai sdk — ai orchestration
• google gemini — llm provider
• prisma — orm
• postgresql — database
• server actions & rsc — secure backend logic
• zustand — lightweight client state (where needed)

---

contributing

Contributions are welcome! Please open an issue or submit a PR.

git clone https://github.com/<YOUR_USERNAME>/study-toolkit.git
cd study-toolkit
npm install
npm run dev

---

environment variables

create a .env file in the project root. use the following .env.example as reference:

# database
DATABASE_URL=postgresql://<user>:<password>@<host>/<database>?sslmode=require

# ai (bring your own key)
GOOGLE_GENERATIVE_AI_API_KEY=your_google_gemini_api_key

# web search (serper)
GOOGLE_SEARCH_BASE_URL=https://google.serper.dev/search
SERPER_API_KEY=your_serper_api_key

# vercel ai gateway (optional / production)
AI_GATEWAY_API_KEY=your_vercel_ai_gateway_key

# email service
RESEND_API_KEY=your_resend_api_key

# encryption
# server-side encryption secret (keep private)
ENCRYPTION_SECRET=your_long_random_secret

# client-safe encryption key
NEXT_PUBLIC_ENCRYPTION_KEY=your_public_encryption_key

# google oauth
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret

# better-auth
# development
BETTER_AUTH_URL=http://localhost:3000

# production
# BETTER_AUTH_URL=https://your-production-domain.com

Prisma migration

npx prisma migrate dev --name db_init

npx prisma generate

---

Created with ❤️ by Subhraneel

GitHub • Twitter