Warning
This repository is deprecated and no longer maintained. VideoNote carries on at videonote.app, developed privately. This code is kept for reference.
A video review app with slick intuitive controls to create timestamped notes on the fly. ✨
- Next.js
- Tailwind CSS
- Framer Motion
- react-intersection-observer
- react-icons
- Amazon DynamoDB via the AWS SDK, infrastructure in AWS CDK (
infra/) - Sentry for errors and uptime (
docs/observability.md) - react-player
- universal-cookie
- nanoid
Some additional experimental features are enabled in tailwind.config.js: uniformColorPalette, extendedSpacingScale, extendedFontSizeScale
- Docker (DynamoDB Local)
- JWT secret
Create a .env.local based on the .env.example for local development.
pnpm install && pnpm db:up && pnpm dev, then pnpm db:seed for demo data.
pnpm test: unit and server testspnpm test:e2e: production build plus Playwright user flows (needsffmpegandpnpm exec playwright install chromium)
Routes under pages/api/ use two small higher-order wrappers from
utils/auth/withAuthenticatedUser.ts to keep authentication out of the
handler bodies:
withAuthenticatedUser(handler)— required for routes that mutate user data (auth,user,settings,project). The handler receives a thirdctxargument with{ userDoc, email, newToken }. Missing/invalid tokens short-circuit with 401; missing users short-circuit with 401.withOptionalUser(handler)— used bypages/api/note.ts, which allows guest note creation. The handler receives a discriminatedctx: either{ isGuest: true, ... null }or the full authenticated context. A token that is present but invalid still 401s — there is no silent fallback to the guest branch.
Shared-project access goes through utils/share/sharePassword.ts:
hashSharePassword(plaintext)— used bypages/api/project.tswhen creating or updating a Share document. Returnsnullfor empty input.verifySharePassword(storedHash, candidate)— used bypages/api/public_project.tswhen reading a shared project. Returns aShareAccessResultdiscriminated union:open|passwordRequired|incorrect|ok.
Note write-path goes through utils/note/noteIntake.ts:
upsertNote(input, authorId)— used bypages/api/note.ts. Creates if_idis not found, updates otherwise. On create also attaches the note id to its Project. PassnullforauthorIdto skip authorship (guest path).removeDoneProjectNotes(projectId)— used by the same handler for theREMOVE_DONE_NOTESaction; returns the surviving notes.
All three modules have unit tests under src/__test__/ that exercise
behaviour through their public interface.