NotebookLM Gallery

A community-driven gallery for discovering and sharing public Google NotebookLM notebooks. Browse curated knowledge bases across categories like Education, Technology, Research, and more.

Cost: $0 — runs entirely on Cloudflare free tier.

---

Tech Stack

Layer	Technology	Why
Frontend	Cloudflare Pages + Tailwind CSS	Free static hosting, global CDN
Backend API	Cloudflare Workers	100k req/day free, serverless
Database	Cloudflare D1 (SQLite)	5GB free, SQL, integrates with Workers
File Storage	Cloudflare R2	10GB free, S3-compatible
Anti-abuse	Cloudflare Turnstile	Free, invisible CAPTCHA alternative
Analytics	Cloudflare Web Analytics	Free, privacy-first
Testing	Vitest + @cloudflare/vitest-pool-workers	CI-native, Miniflare D1/R2 emulation

Architecture

Visitor → Cloudflare CDN → Cloudflare Pages (HTML/CSS/JS)
                              │
                              ▼ (API calls from browser)
                         Cloudflare Workers (API logic)
                              │
                              ├── D1 Database (notebooks, likes)
                              └── R2 Storage (preview images)

The frontend is a multi-page static site served by Cloudflare Pages. The backend is a single Cloudflare Worker with D1 for persistent storage and R2 for image uploads.

Prerequisites

• Node.js v18 or later
• Wrangler CLI: npm install -g wrangler
• A Cloudflare account (free tier)

Local Development

1. Clone and install

git clone <repo-url>
cd notebooklm-marketplace
cd workers/api && npm install

2. Set up D1 database

cd workers/api
wrangler d1 create notebooklm-marketplace
# → Copy the database_id into wrangler.toml

3. Set up R2 bucket

wrangler r2 bucket create notebooklm-marketplace-previews

4. Run the Worker locally

cd workers/api
wrangler dev

The API will be available at http://localhost:8787. The frontend can be served with any static file server:

cd frontend
python -m http.server 3000

5. Run D1 migrations

cd workers/api
wrangler d1 migrations apply notebooklm-marketplace --local

6. Set up Turnstile

Create a Turnstile site key in the Cloudflare Dashboard. Set the environment variable:

echo "TURNSTILE_SECRET_KEY=your_secret" >> workers/api/.env
echo "TURNSTILE_SITE_KEY=your_site_key" >> frontend/.env

Testing

Tests run with Vitest + @cloudflare/vitest-pool-workers for real D1 and R2 emulation via Miniflare.

Run all tests

cd workers/api
npm test

Test layout

Layer	File	Tests	What it covers
Unit	test/unit/validation.test.js	36	Title, description, URL, categories, tags — every branch
Unit	test/unit/ip.test.js	4	Hash determinism, different IPs, hex format
Integration	test/integration/submit.test.js	11	Full submit flow: validation, Turnstile, rate limiting, image upload, CORS
Integration	test/integration/turnstile.test.js	4	Dev mode bypass, missing/invalid tokens
Integration	test/integration/ratelimit.test.js	3	Allow/block logic over the hourly window

Total: 58 tests.

Run a specific test file

cd workers/api
npx vitest run test/unit/validation.test.js

Run in watch mode (development)

cd workers/api
npx vitest

How integration tests work

• D1 and R2 are emulated via Miniflare (no real infrastructure needed)
• Turnstile uses its built-in dev mode: when TURNSTILE_SECRET is not set, verification passes automatically
• Rate limiting runs against an in-memory D1 with seeded log data
• Tests call handlers directly (handleSubmit()) with mocked Request and env objects

CI/CD (GitHub Actions)

This repo includes two GitHub Actions workflows:

Workflow	Trigger	What it does
deploy.yml	Push to main	Deploys the Worker and frontend to Cloudflare Pages
test.yml	Pull request to main	Runs all 58 tests with Node.js 20

Secrets

Configure these in your repo's Settings → Secrets and variables → Actions:

• CF_API_TOKEN: Cloudflare API token with Workers and Pages permissions

API Endpoints

Method	Path	Description
GET	/api/notebooks	List notebooks (paginated, filterable)
GET	/api/notebooks/:id	Get notebook detail
POST	/api/notebooks	Submit a new notebook
POST	/api/notebooks/:id/like	Toggle like on a notebook
GET	/api/categories	List categories with counts
GET	/api/tags/trending	List trending tags

Project Structure

notebooklm-marketplace/
├── frontend/               # Cloudflare Pages site
│   ├── index.html          # Discover page (notebook grid)
│   ├── notebook.html       # Notebook detail page
│   ├── submit.html         # Submission form
│   ├── css/style.css       # Tailwind + custom styles
│   └── js/                 # Client-side JavaScript
├── workers/
│   └── api/                # Cloudflare Workers API
│       ├── src/
│       │   ├── index.js    # Entry point + router
│       │   ├── db/schema.js
│       │   ├── handlers/   # Route handlers
│       │   ├── middleware/  # CORS, rate limit, Turnstile
│       │   └── utils/      # Validation, IP hashing
│       ├── test/
│       │   ├── unit/       # 2 files, 40 tests (pure functions)
│       │   └── integration/ # 3 files, 18 tests (Worker handlers)
│       ├── vitest.config.mjs
│       ├── wrangler.toml
│       └── package.json
├── openspec/               # SDD artifacts
├── .github/workflows/      # deploy.yml + test.yml
└── README.md

License

MIT