beztebya666/notes-ui repository overview

⁠notes-ui

🚀 Live demo →⁠ — each visitor gets their own session in localStorage.

A fast, keyboard-friendly grid of links (dashboards, dev/test/prod stands, docs, contacts) that everyone on the team can edit and everyone sees in real time. No accounts, no SaaS, no third-party dependencies — one shared password, one SQLite file, one Docker image.

⁠Quick start

docker run -d --name notes-ui \
  -p 8080:8080 \
  -v notes-ui-data:/app/data \
  -e EDIT_PASSWORD=please-change-me \
  -e PORTAL_LANG=en \
  beztebya666/notes-ui:1.1.1

Open http://localhost:8080⁠. Click Sign in, paste the edit password, start editing. Switch to Russian with -e PORTAL_LANG=ru. Also on GHCR: ghcr.io/beztebya666/notes-ui:1.1.1.

⁠Demos

Live editing	Command palette	Theme switch

⁠Screenshots

Per-environment Stands (DEV / INT / LT / PROD)	Contacts grouped by role
Command palette (Ctrl/⌘ K)	Inline search across names, tags, URLs, notes
Sign-in with shared password + editor name	Add/edit a link with tags and icon picker
Diagnostics — duplicates, empty URLs, untagged	Russian UI (PORTAL_LANG=ru) — bilingual

⁠Tags

⁠Features

• Sections out of the box: Main links, per-environment stands (DEV / INT / LT / PROD), Useful third-party links, and a Contacts directory. Create your own sections (flat list / multi-env grid / grouped) at runtime.
• Live sync over WebSocket — every browser tab connected to the same server sees edits within milliseconds.
• Edit mode behind one shared password (EDIT_PASSWORD); separate read password (READ_PASSWORD) — leave empty to keep the portal public-read.
• Per-user customization on top of shared data: pin cards, add personal notes, hide built-ins — kept in localStorage, never overwritten by team edits.
• Command palette (Ctrl/⌘ K), fuzzy search across names/tags/URLs/notes, audit panel (dead URLs / duplicates / missing tags).
• Edit history for every card (who/when), with optional manual undo.
• Automatic backups: SQLite is snapshotted to BACKUP_DIR on a schedule.
• Bilingual UI: English by default, Russian via PORTAL_LANG=ru.
• Demo mode (PORTAL_DEMO=true): drop-in client-side shim that runs the same UI with localStorage-only state — powers the GitHub Pages demo.
• Ships in five forms: Docker image, Helm chart, .deb / .rpm, standalone pkg binary, and a Chrome MV3 extension.

⁠Configuration

⁠Persistence

docker volume create notes-ui-data
docker run -d --name notes-ui -p 8080:8080 \
  -v notes-ui-data:/app/data \
  -e EDIT_PASSWORD=change-me \
  beztebya666/notes-ui:latest

The image runs as a non-root user (uid 1000). For host-path mounts, ensure uid 1000 has write access.

⁠Helm

git clone https://github.com/beztebya666/notes-ui.git
cd notes-ui
helm install portal charts/portal \
  --namespace portal --create-namespace \
  --set secrets.editPassword=change-me \
  --set ingress.enabled=true \
  --set ingress.hosts[0].host=portal.example.com

image.repository defaults to beztebya666/notes-ui. Chart features: HPA, PDB, NetworkPolicy, ServiceMonitor, custom CA, configurable PVC.

⁠Links

• Live demo: https://beztebya666.github.io/notes-ui/⁠
• Source: https://github.com/beztebya666/notes-ui⁠
• Releases: https://github.com/beztebya666/notes-ui/releases⁠
• Issues: https://github.com/beztebya666/notes-ui/issues⁠
• License: MIT⁠