clipmark

Context

clipmark is an in-development local project built to make knowledge capture fast and structured:

• save a URL manually,
• attach notes, excerpts, and tags,
• search and filter in one place,
• keep a reader view for markdown context next to your queue.

It is tracked as in-progress/local because there is no public repo for this iteration.

Features

• URL capture with required validation for clean source entries.
• Rich item model with title, excerpt, markdown notes, tags, and timestamps.
• Two-panel interface pattern: a left feed + right reader with metadata and actions.
• Tag extraction and query filtering for fast retrieval.
• Delete, open, and update flows through API routes with server-side state mutations.
• Full-stack persistence through Prisma models and migrations.

Stack

• Frontend: Next.js App Router, React hooks, React Markdown rendering.
• Backend/API: Next.js route handlers for list/create/delete operations.
• Storage: Prisma client with relational schema and generated migration flow.
• Tooling: TypeScript lint/build/test workflow via next lint and next build.

Notes and decisions

• I kept manual capture as the initial interaction model to avoid hard dependencies on third-party parser pipelines.
• Tags and markdown fields are designed to stay lightweight so the app stays usable even when browser extraction quality varies.
• State operations are intentionally explicit and local-first, with UI status surfaced for async save/delete actions.

Next steps

• Add browser extension/API integrations for one-click import.
• Add richer full-text indexing and tag scoring.
• Add auth-aware sync options while keeping the local-first mode as default.

References

• Next.js Docs
• Prisma Docs
• React Docs