Hiccup

Hiccup is a static, configurable start page and new-tab replacement for quickly accessing important links. It is implemented as a client-side React + TypeScript single-page app and can be served from any static host or Docker image.

Key Features

• Static single-page application built with React and TypeScript, optimized for fast access
• Config-driven: uses a JSON config as the source of truth with a built-in config manager (load local or remote configs)
• Featured links and categories with tag support and a searchable index of links
• Drag-and-drop support to add/edit links and background images directly from the browser
• Search that can query multiple search providers and link/tags; customizable providers
• Progressive Web App (PWA) support, caching strategies and offline-capable behaviors
• Keyboard shortcuts and full keyboard navigation for quick access
• Multiple profiles, read-only mode, and localStorage persistence for local edits
• Docker support and static-host friendly build artifacts for easy deployment

Use Cases

• A personal home server or browser new-tab page to centralize frequently used links
• Shared kiosks or team dashboards with preloaded configs for quick access to resources
• Lightweight curated link hubs for low-ops deployments on static hosting or container platforms

Limitations and Considerations

• Edits made in the editor are stored in the browser's localStorage by default; synchronizing across devices requires hosting and sharing a config file
• Loading remote configs depends on the remote server allowing CORS for raw JSON access
• The built-in edit UI imposes default limits (e.g., four featured cards and four categories) unless the JSON config is manually modified
• No built-in server-side user accounts or automatic cross-device sync; intended as a static client-side start page

Hiccup is suited for users who want a simple, fast, and customizable start page that can be deployed without a backend. It emphasizes local control, easy deployment, and quick navigation.