URL Link Catalog

https://urlinkcat.pages.dev/#demo

URL Link Catalog, or URLinkCat, is a free, open-source, fully customizable, multi-user, cloud-synced and easy-to-use bookmark web app.

🏆 This project won Cloudflare Developer Summer Challenge 2021. Thank you Cloudflare for the prize box!

Who wants it?

You need it if you want to:

• Acess personal bookmarks across browsers and devices
• Acess bookmarks across work and personal accounts
• Share links with a group of people
• Collaboratively create a internet directory with firends
• Publish your up-to-date collection of your favorite AIs since 2023!

Comparison

1: Optional password protection coming soon™

User Guide

Check out our official examples listed on https://urlinkcat.pages.dev/#demo.

1. Visit https://urlinkcat.pages.dev/#ImSuperHero123 to view the page of ImSuperHero123.^1,2
2. Manage. No need accounts. Just click bottom-right 🔒 button to toggle editing mode.³
3. Preview. Click 🔒 button again to toggle viewer mode.
4. Save to Cloud. Click the ☁️ cloud button in viewer mode. If ☁️ shift to ✔️, congratulations, your masterpiece is in the could!

Tips:

1. To make bookmark "private", use a page id hard to guess like SUxPVkVV. Search engines won't know unless you speak it out loud.
2. Visiting https://urlinkcat.pages.dev/ barely will give you a random ID.
3. You will need codename to change thumbnails and colors, and the codenames can be found from the default "How to Use" section.

Host your own instance

Front-end hosting on Cloudflare Pages

1. Fork me on GitHub
2. Change the config at "src/routes/App.svelte" and/or "static/data_default.json"
3. Follow the steps on Cloudflare Pages document
4. Setup "Build Configurations" as below.

Framework preset: Svelte
Build command: pnpm run build
Build output directory: /static

Your instance is now ready to use, but only within a browser tab session. To enable cloud storage, keep following steps blow.

Back-end hosting on Cloudflare Workers and KV

1. Create a new Cloudflare Workers instance on https://workers.dev/
2. Create a KV namespace and bind it to this workers instance. Default name is URLinkCat.
3. Copy & paste ".cf_workers/main.js" to Cloudflare Workers Quick Edit.
4. Click "Save and deploy" on Quick Edit. (wrangler not required)

Double-check if cf_workers value in "src/routes/App.svelte" matches your back-end address.

Now you should find your instance up and running!

Developer notes

Architecture:

                ┌────────────x.pages.dev──┐
                │                         │
                │   ┌────────┐            │
                │   │.svelte │            │
                │   └─┬──────┘            │
                │     │                   │
                │     │ compile           │
                │     ▼                   │
┌─────────┐     │   ┌───────────────┐     │   ┌───────────────┐    ┌──────────┐
│  User   ├─────┼──►│.html/.css/.js │◄────┼──►│y.z.workers.dev│◄──►│Workers KV│
└─────────┘     │   └───────────────┘     │   └───────────────┘    └──────────┘
                │                         │       middleware         database
                └─────────────────────────┘
                      frontend

Contribution

Feel free to send PR. Consider following improvements:

• Change orders by dragging
• Optional password protection
• Depolyment on other playforms (vercel, deno deploy, render.com, etc.)
• Open a group of links at once by a single click (firefox bookmark toolbar "Open All in Tabs")