Add cloud storage with GitHub and Google login

[pearmini]

close: #107

Summary

Notebooks are now saved to Firebase (Firestore) instead of only localStorage, with login via GitHub or Google.

• Login: a new icon at the far right of the nav opens "Continue with GitHub / Google". Once logged in, it shows the user's avatar with their email and "Log out". Login uses a popup, so an unsaved notebook stays on screen.
• Saving requires login: when logged out, Create, Duplicate (including from Examples) and ⌘S open the login menu, then continue once the user has logged in.
• Upload on login: existing localStorage notebooks are uploaded to the user's account, then cleared locally.
• Logged out: local notebooks can still be opened and run from /works, but edits aren't saved and delete is hidden.
• Autosave: edits and renames are written about 800 ms after the last change.
• Freeze guard: the "don't auto-run a notebook that froze last time" guard now uses a local flag instead of writing autoRun on every run.

Implementation

• app/firebase.js: lazy Firebase init, so server rendering never touches Firebase.
• app/auth.js: auth store (same useSyncExternalStore pattern as app/store.js) and ensureUser().
• app/api.js: notebook reads and writes are async and stored at users/{uid}/notebooks/{id}.
• firestore.rules: users can only read and write their own notebooks.

Setup

• The Firebase project is recho-dev, with GitHub and Google providers enabled.
• The four NEXT_PUBLIC_FIREBASE_* variables are set in Vercel for all environments. See .env.example for local development.
• Rules are deployed with firebase deploy --only firestore:rules.

Test plan

• pnpm test:lint, pnpm test:typecheck, prettier check, vitest (187 tests)
• pnpm app:build
• Logged out: Create opens the login menu; local notebooks run but don't save
• Log in with GitHub and Google; local notebooks are uploaded and localStorage is cleared
• Edit, rename, duplicate and delete all persist after a reload
• A second account can't see the first account's notebooks

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
recho-notebook	Ready	Preview	Sep 13, 2026 4:41pm UTC

[Copilot]

🟡 Changes recommended

Unsaved edits can be overwritten or silently lost during login, autosave failures, and page unloads.

Get a fresh assessment by requesting another Copilot review.

Pull request overview

Adds Firebase authentication and Firestore-backed notebook persistence, including local notebook migration and autosaving.

Changes:

• Adds GitHub/Google login and account navigation.
• Migrates notebook storage from localStorage to Firestore.
• Adds debounced autosaving, migration, and freeze-state tracking.

File summaries

File	Description
.env.example	Documents Firebase configuration variables.
.firebaserc	Selects the Firebase project.
.gitignore	Excludes local Firebase artifacts and environment files.
app/EditorPage.jsx	Integrates authentication, cloud loading, and autosaving.
app/Nav.jsx	Adds the login and account menu.
app/api.js	Implements Firestore persistence and local migration.
app/auth.js	Adds authentication state and login flows.
app/examples/ExampleEditor.jsx	Requires login before duplication.
app/firebase.js	Lazily initializes Firebase services.
app/works/page.jsx	Loads and deletes cloud notebooks.
firebase.json	Configures Firestore rules deployment.
firestore.rules	Restricts notebooks to their owners.
package.json	Adds the Firebase dependency.
pnpm-lock.yaml	Locks Firebase and transitive dependencies.

Review details

Files not reviewed (1)

• pnpm-lock.yaml: Generated file

• Files reviewed: 12/14 changed files
• Comments generated: 6
• Review effort level: Balanced

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.