How vvvasavii/woven works
Woven is a personal bookmark and knowledge library. Users create bookmarks from generated or edited link previews, organize them into collections, add notes and attachments, favorite resources, and search within dashboard, bookmark, collection, or favorite views. Client pages call Next.js route handlers; handlers authenticate and authorize through the user mapping, then use Prisma for persistent records. The preview, attachments, image uploads, and contextual search are distinct capabilities. Relationships below follow shown excerpts or README statements; links for unsampled page/API behavior rely on documented capabilities and are marked dashed where not directly evidenced.
Main entry points: bookmarks/page.tsx Bookmarks page · auth.ts User identity mapping · dashboard/page.tsx Dashboard · route.ts Bookmark handlers
Components 28
User experience
- Dashboard
app/dashboard/page.tsx - Bookmarks page
app/bookmarks/page.tsx - Collections page
app/collections/page.tsx - Collection detail
app/collections/[id]/page.tsx - Favorites page
app/favorites/page.tsx - Bookmark detail
components/dashboard/BookmarkDetailDialog.tsx - Create bookmark
components/dashboard/CreateBookmarkDialog.tsx - Collection dialogs
components/collections/CreateCollectionDialog.tsx
Bookmarks and discovery
- Bookmark handlers
app/api/bookmarks/route.ts - Bookmark item handlers
app/api/bookmarks/[id]/route.ts - Favorites handler
app/api/favorites/route.ts - Search handler
app/api/search/route.ts - Link preview
app/api/link-preview/route.ts - Bookmark card
components/dashboard/BookmarkCard.tsx
Collections
- Collection handlers
app/api/collections/route.ts - Collection item handlers
app/api/collections/[id]/route.ts - Collection membership
app/api/bookmarks/[id]/collections/route.ts - Attachment handlers
app/api/bookmarks/[id]/attachments/route.ts - Attachment item handler
app/api/bookmarks/[id]/attachments/[attachmentId]/route.ts - Attachment upload
components/attachments/AttachmentUpload.tsx - Collection image upload
components/collections/CollectionImageUpload.tsx
Application backend
- User identity mapping
lib/auth.ts - PostgreSQL
- Prisma client
lib/prisma.ts
Identity and services
- Clerk
- Cloudinary
- Cloudinary signing
app/api/cloudinary/sign/route.ts
Other components
- User
Connections 42
- User → Dashboard: uses
app/dashboard/page.tsx - User → Bookmarks page: uses
app/bookmarks/page.tsx - User → Collections page: uses
app/collections/page.tsx - User → Collection detail: uses
- User → Favorites page: uses
- Dashboard → Bookmark handlers: fetches
app/dashboard/page.tsx - Dashboard → Collection handlers: fetches
app/dashboard/page.tsx - Bookmarks page → Bookmark handlers: fetches
app/bookmarks/page.tsx - Collections page → Collection handlers: fetches
app/collections/page.tsx - Dashboard → Create bookmark: opens
app/dashboard/page.tsx - Bookmarks page → Create bookmark: opens
app/bookmarks/page.tsx - Bookmarks page → Bookmark detail: opens
app/bookmarks/page.tsx - Collections page → Collection dialogs: opens
app/collections/page.tsx - Bookmarks page → Bookmark card: renders
app/bookmarks/page.tsx - Favorites page → Bookmark card: renders
app/favorites/page.tsx - Bookmark detail → Attachment upload: renders
components/dashboard/BookmarkDetailDialog.tsx - Bookmark card → Bookmark item handlers: updates favorite
components/dashboard/BookmarkCard.tsx - Create bookmark → Link preview: requests preview
- Create bookmark → Bookmark handlers: creates bookmark
- Bookmark handlers → User identity mapping: identifies user
app/api/bookmarks/route.ts - Collection handlers → User identity mapping: identifies user
app/api/collections/route.ts - Collection item handlers → User identity mapping: identifies user
app/api/collections/[id]/route.ts - Bookmark handlers → Prisma client: queries
app/api/bookmarks/route.ts - Collection handlers → Prisma client: queries
app/api/collections/route.ts - Collection item handlers → Prisma client: queries
app/api/collections/[id]/route.ts - User identity mapping → Clerk: authenticates
lib/auth.ts - User identity mapping → Prisma client: maps user
lib/auth.ts - Prisma client → PostgreSQL: reads and writes
lib/prisma.ts - Link preview → User: returns metadata
- Favorites page → Favorites handler: loads favorites
- Dashboard → Search handler: searches
- Bookmarks page → Search handler: searches
- Collections page → Search handler: searches
- Favorites page → Search handler: searches
- Collection detail → Collection item handlers: loads collection
- Collection detail → Collection membership: manages membership
- Bookmark detail → Attachment handlers: manages attachments
- Attachment upload → Attachment handlers: uploads
- Attachment item handler → Cloudinary: deletes media
app/api/bookmarks/[id]/attachments/[attachmentId]/route.ts - Collection image upload → Cloudinary signing: requests signature
- Cloudinary signing → User identity mapping: identifies user
app/api/cloudinary/sign/route.ts - Cloudinary signing → Cloudinary: signs upload