Bookmarks

A self-hosted bookmark manager with short URL redirects. Save websites with custom aliases and access them via short URLs like https://bm.suram.in/r/gh.

Built with Go and SQLite. See it live at bm.suram.in.

Features

• Short URL redirects — bookmark any URL with a custom alias
• Inline editing — click any cell to edit directly in the table
• Search & filter — live search across all bookmarks
• Admin controls — secret-based auth for adding, editing, and deleting
• Hidden aliases — aliases starting with _ are hidden unless authenticated
• Template aliases — regex-based alias patterns for dynamic redirects
• Chrome extension — quickly add bookmarks from the browser (readme)

Quick Start

Prerequisites

• Go (or use GVM to manage versions)
• GCC (required for go-sqlite3 CGO bindings)
• Make

Setup & Run

make setup # creates dev.db from the test schema
make build # fetches deps and compiles the binary
make run # runs setup + build, then starts the server

The server starts at http://localhost:8085.

Other Commands

make test# run tests
make clean # remove binary and dev.db

Database Schema

CREATETABLE "aliases" (
`orig`TEXT,
`alias`TEXT UNIQUE,
`rec_id`INTEGERPRIMARY KEY AUTOINCREMENT
);
CREATEINDEXaliases_orig_indexON"aliases" (orig);
CREATETABLE `config` (
`key`TEXT,
`value`TEXT,
PRIMARY KEY(key)
);

Use internal/testdata/test_db for an empty sqlite file with this schema, or run scripts/setup_db.sh <path> if you have sqlite3 installed.

Admin Features

To enable admin features, insert a secret into the config table:

INSERT INTO config ("key", "value") VALUES ("bm_secret", "YOUR_SECRET_KEY");

Once set:

1. Modifications (add/edit/delete) require the secret in the request.
2. Aliases starting with _ are hidden unless the secret is provided.

Project Structure

├── main.go # entry point
├── internal/
│ ├── db.go # sqlite storage layer
│ ├── handlers.go # HTTP request handlers
│ ├── router.go # route definitions
│ ├── structures.go # data types and response builders
│ ├── logger.go # logging setup
│ ├── server_test.go # integration tests
│ └── static/ # frontend assets (served at /)
│ ├── index.html
│ ├── css/style.css
│ └── js/app.js
├── scripts/
│ ├── setup_db.sh # create a new db with schema
│ └── supervisor_aws.conf # example supervisor config
├── chrome_plugin/ # chrome extension source
├── Makefile # dev workflow commands
├── DEV_SETUP.md # detailed developer setup guide
└── ISSUES.md # tracked issues and feature requests

License

See LICENCE.