🎓 leanlearn

leanlearn is a modern, high-performance Learning Management System (LMS) built for speed and simplicity. It leverages a Cloudflare-native stack (Pages, D1, Workers) to provide a "Lean" experience for both learners and developers.

Explore the Docs · Report Bug · Request Feature

---

📸 Preview

Get Started with leanlearn


Intuitive Student Dashboard


Course Completion View


Generated Digital Certificate


Detailed Learner Profile & Progress


Secure Authentication

---

✨ Key Features

• 🔐 Robust Authentication: Secure Google OAuth integration powered by Better Auth.
• 📖 Structured Learning: Hierarchical courses, chapters, and activities (Text/Video).
• 📈 Progress Persistence: Real-time progress tracking with automatic saving to Cloudflare D1.
• 🎓 Automated Certification: Earn printable A4 landscape certificates upon 100% course completion.
• 📊 Learner Profile: Aggregated statistics including average progress and earned certificates.
• ⚡ Performance Optimized: Parallel data fetching, aggressive asset caching, and minimal bundle size.

🛠 Tech Stack

• Framework: React Router v7 (Full-stack)
• Server: Hono (Lightweight & Cloudflare-ready)
• Database: Cloudflare D1 (Edge SQLite)
• ORM: Drizzle ORM
• Auth: Better Auth
• Testing: Vitest
• Styling: Vanilla CSS Variables (The "Lean" way)

🚀 Getting Started

Prerequisites

• Node.js >= 20
• Cloudflare Wrangler CLI

Quick Setup

1. Clone the repository:

   git clone https://github.com/adityak74/leanlearn.git
   cd leanlearn

2. Install dependencies:

   npm install

3. Configure Environment: Create a .dev.vars file for local development:

   BETTER_AUTH_SECRET="your_secret"
   BETTER_AUTH_URL="http://localhost:5173"
   GOOGLE_CLIENT_ID="your_google_id"
   GOOGLE_CLIENT_SECRET="your_google_secret"

4. Initialize Local Database:

   npx drizzle-kit push --config=drizzle.dev.config.ts
   node scripts/seed-local.js

5. Start Developing:

   npm run dev

For detailed instructions, see the Setup Guide.

📁 Project Structure

├── app/
│   ├── db/          # Schema and Database Helpers
│   ├── lib/         # Shared libraries (Auth client, etc.)
│   ├── routes/      # Page routes and API endpoints
│   ├── styles/      # Global styling (app.css)
│   ├── root.tsx     # Root layout and global providers
│   └── server.ts    # Hono server entry point
├── migrations/      # D1 migration files
├── scripts/         # Seeding and maintenance scripts
├── tests/           # Vitest integration tests
└── wrangler.jsonc   # Cloudflare deployment config

🧪 Testing

Run the automated test suite to verify business logic:

npm test

☁️ Deployment

One-Click Deploy

You can deploy this entire stack (including D1 database setup) directly to Cloudflare using the button below:

Manual Deployment

Deploy to Cloudflare Pages manually using the Wrangler CLI:

npm run deploy

Note: Ensure you have your D1 database and KV namespaces configured in wrangler.jsonc before manual deployment.

📄 License

Distributed under the MIT License. See LICENSE.md for more information.

---

Built with ❤️ by Aditya Karnam