cyzzxc/flare repository overview

⁠Flare

Lightweight personal start page / bookmark homepage. Single Go binary, no database — apps, bookmarks, and settings live as YAML next to the process.

Source: github.com/cyzzxc/flare⁠

Fork of soulteary/flare⁠, maintained for multi-arch Docker use and agent-friendly APIs.

⁠vs upstream

Empty/unknown icon names render blank (no MDI→Remix mapping). Old MDI-style names like homeCircle will not show an icon.

⁠Quick start (Compose)

services:
  flare:
    image: cyzzxc/flare:latest
    container_name: flare
    ports:
      - "5005:5005"
    volumes:
      - ./data:/app
    restart: unless-stopped

docker compose up -d
# open http://localhost:5005
# YAML data: ./data/{apps,bookmarks,config}.yml

⁠Docker run

docker run -d --name flare \
  -p 5005:5005 \
  -v "$PWD/data:/app" \
  cyzzxc/flare:latest

⁠Optional environment

⁠API (agents)

• GET /llm.txt — usage notes (no auth)
• GET/PUT /api/v1/apps · /api/v1/bookmarks · /api/v1/settings
• GET /api/v1/icons?q=&limit=20
• Health: GET /ping → {"message":"pong"}

⁠Links

• GitHub: https://github.com/cyzzxc/flare⁠
• Upstream: https://github.com/soulteary/flare⁠