Get Started in 3 Minutes
This guide will walk you through creating an account, saving your first bookmark, and organizing it with AI-powered tags.Create Your Account
Navigate to the application homepage and click the sign-in button. You’ll see two authentication options:
Sign In with Magic Link
- Enter your email address in the input field
- Click Continue with email
- Check your inbox for the magic link
- Click the link to instantly sign in
Sign In with GitHub
Click Continue with GitHub to authenticate using your GitHub account. You’ll be redirected to GitHub for authorization.Login.tsx:31-38
The magic link is valid for 1 hour and can only be used once for security reasons.
Save Your First Bookmark
Once authenticated, you’ll see the bookmark input at the bottom of the screen.
Add a Bookmark
- Paste a URL: Click the paste icon or use
Ctrl+Vto paste from clipboard - Type manually: Enter any valid URL starting with
https:// - Submit: Click the arrow icon or press
Enter
- Validate the URL format
- Fetch website metadata (title, description, favicon)
- Extract the domain and preview image
- Save to your collection
AddBookmark.tsx:18-24
What Happens Behind the Scenes
When you save a bookmark, the system:BookmarkStore.ts:47-66
Organize with Tags
Tags help you categorize and quickly find your bookmarks later.
Add Tags Manually
- Click on the “add tags…” text below any bookmark
- Type a tag name and press
,(comma) orEnter - Add multiple tags by repeating step 2
- Click the checkmark icon to save
Tag Editing Features
The tag editor supports:- Multiple tags: Separate with comma or Enter key
- Remove tags: Click the X icon when editing
- Backspace editing: Press backspace to edit the last tag
- Auto-save: Tags are saved to Supabase when you confirm
BookmarkTags.tsx:33-40
Generate AI Tags
While manual tagging is available, the application is designed to support AI-assisted tag generation based on bookmark content and metadata.Find Bookmarks Fast
Use the powerful search capabilities to find any bookmark instantly.The search indexes:
Command Menu Search
Press⌘K (Mac) or Ctrl+K (Windows/Linux) to open the command menu:CommandMenu.tsx:14-23
- Bookmark titles
- Full URLs
- All associated tags
Filter by Tags
Click any tag to filter your bookmarks by that category. Only bookmarks with the selected tag will be displayed.Time-Based Filtering
Click the calendar icon in the bottom input to cycle through:- All time: Show all bookmarks
- Last month: Bookmarks from the past 30 days
- Last week: Bookmarks from the past 7 days
Sort Order
Toggle between newest first and oldest first by clicking the sort icon:AddBookmark.tsx:72-80
Common Operations
Edit a Bookmark
- Click the three-dot menu on any bookmark card
- Select Edit
- Modify the title, description, or URL
- Click Save to update
Delete a Bookmark
- Click the three-dot menu on any bookmark card
- Select Delete
- Confirm the deletion in the modal
Pin Important Bookmarks
Pinned bookmarks always appear at the top of your list, regardless of the sort order. Use this feature for frequently accessed websites.Keyboard Shortcuts
Master these shortcuts for maximum productivity:| Shortcut | Action |
|---|---|
⌘K / Ctrl+K | Open command menu |
↑ / ↓ | Navigate search results |
Enter | Open selected bookmark |
Esc | Close command menu |
, or Enter | Add tag (when editing) |
Backspace | Edit last tag (when editing) |
Next Steps
Installation Guide
Learn how to self-host the application with your own Supabase instance
API Reference
Explore the stores, utilities, and components API