{"id":19548995,"url":"https://github.com/ashwin-pc/hiccup","last_synced_at":"2025-10-30T00:08:41.640Z","repository":{"id":38997819,"uuid":"273879615","full_name":"ashwin-pc/hiccup","owner":"ashwin-pc","description":"A static start page to get to your most important links, FAST.","archived":false,"fork":false,"pushed_at":"2025-08-09T18:58:10.000Z","size":38528,"stargazers_count":176,"open_issues_count":14,"forks_count":20,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-08-09T20:44:24.527Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ashwin-pc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-06-21T10:14:24.000Z","updated_at":"2025-08-09T18:58:15.000Z","dependencies_parsed_at":"2025-01-19T00:39:49.508Z","dependency_job_id":"c80a74d8-d1a3-47c0-b2a1-433f4cd34da0","html_url":"https://github.com/ashwin-pc/hiccup","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/ashwin-pc/hiccup","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashwin-pc%2Fhiccup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashwin-pc%2Fhiccup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashwin-pc%2Fhiccup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashwin-pc%2Fhiccup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ashwin-pc","download_url":"https://codeload.github.com/ashwin-pc/hiccup/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashwin-pc%2Fhiccup/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281720291,"owners_count":26549957,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-29T02:00:06.901Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-11T03:57:37.121Z","updated_at":"2025-10-30T00:08:41.622Z","avatar_url":"https://github.com/ashwin-pc.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hiccup\n\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/ashwin-pc/hiccup)\n![GitHub](https://img.shields.io/github/license/ashwin-pc/hiccup)\n[![Tests](https://github.com/ashwin-pc/hiccup/actions/workflows/tests.yml/badge.svg?branch=master\u0026event=push)](https://github.com/ashwin-pc/hiccup/actions/workflows/tests.yml/badge.svg?branch=master\u0026event=push)\n[![CI](https://github.com/ashwin-pc/hiccup/actions/workflows/deploy_to_server.yml/badge.svg)](https://github.com/ashwin-pc/hiccup/actions/workflows/deploy_to_server.yml)\n\n![](public/logo192.png)\n\nA static start page to get to your most important links, **FAST**. You can use this for your home server, new tab using browser extentions, use the **demo page** directly or basically anywhere you can server a static webpage from!\n\n### [Live Demo](https://designedbyashw.in/test/hiccup/)\n\n## Features\n\n- Static Webpage\n- Featured Links\n- Categories\n- Drag to add links and images\n- Search\n  - Supports various search providers and custom ones too\n  - Links and tag support\n- Docker support\n- Multiple profiles\n- Load remote profile\n- Caching strategies\n- PWA support\n- Keyboard shortcuts\n- Read Only mode\n- Full keyboard navigation support\n\n![Main screen](docs/assets/main-desktop.png)\n\n## Screens\n\n\u003cdiv align=\"center\"\u003e\n\u003ctable style=\"width:100%; border: none;\"\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cb\u003eDesktop\u003c/b\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cb\u003eMobile\u003c/b\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cb\u003eLanding Page\u003c/b\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"docs/assets/main-desktop.png\" alt=\"Landing Page Desktop\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"docs/assets/main-mobile.png\" alt=\"Landing Page Mobile\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cb\u003eQuickly find links\u003c/b\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"docs/assets/search-desktop.png\" alt=\"Landing Page Desktop\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"docs/assets/search-mobile.png\" alt=\"Landing Page Mobile\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cb\u003eEasily edit links\u003c/b\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"docs/assets/edit-desktop.png\" alt=\"Landing Page Desktop\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"docs/assets/edit-mobile.png\" alt=\"Landing Page Mobile\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cb\u003eLocally manage config using JSON\u003c/b\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"docs/assets/config-manager-desktop.png\" alt=\"Landing Page Desktop\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"docs/assets/config-manager-mobile.png\" alt=\"Landing Page Mobile\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\u003c/div\u003e\n\nDrag \u0026 drop config file\n\n![Drag \u0026 drop config file](docs/assets/screen-drop.png)\n\n## Getting started\n\nThis project was bootstrapped with [Create React App](https://github.com/facebook/create-react-app). Serve the release build or use any of the available react scripts to run the app.\nThe startpage uses a `config.json` file as the source of truth for page. It can be modified locally but the result will only be saved on the browsers `localStorage` and persist across sessions.\n\n### Installation\n\nTo use the app, you have many options\n\n#### [Hosted site](https://test.designedbyashw.in/hiccup)\n\nI have hosted an instance of the app [here](https://test.designedbyashw.in/hiccup). Since this is a static site, chages you make to the links only exist locally on your browser and are never sent anywhere. To save the links to other browsers, just doenload the config file from the editor using the download button and drag the config file onto a new instance of hiccup on your new browser. The links in your config stay private. You can even have multiple config files that you can load based on your need.\n\n#### Docker\n\nTo run the app using docker the image `bleckbeard/hiccup:latest`. You can use the command below or the `docker-compose.yaml` file from the repo. Be sure to change the volume to the location of your local config file. Use the one in `./public/configs/config.json` for reference.\n\n```\ndocker run \\\n    -p 8899:80 \\\n    -v `pwd`/public/configs/config.json:/usr/share/nginx/html/configs/config.json \\\n    bleckbeard/hiccup:latest\n```\n\n#### Using a static site host\n\nYou cann download the built file or build it yourself and deploy to a static site provider like netlify or github-pages (or any other way to host a static site). To persist the config, edit the local config file. You can always sync the version of your config file to this using the config editor.\n\n### Hotkeys\n\nThe app has a few hotkeys to help you easily navigate around. To quickly view the available hotkeys, use the `Cmd/Ctrl + /` hotkey!\n\n\u003e Note: Hotkeys do not work when the search is bar is in focus. Use `Tab` to focus out of the search bar and into the app or click anywhere outside the search bar to use hotkeys\n\n### Using Search\n\nThe purpose of the search is to get to you link as easily as possible. The search bar is a powerful tool to search across many search providers e.g. Google, Amazon, Duck Duck Go and Links (including tags)\n\n- Press `UpArrow` and `DownArrow` to navigate the search\n- Press `Esc` to quit the search\n- Hit `Enter` to open the first highlighted link amongst search results. (Featured cards have a star and the Search provider is marked by a globe)\n\nSearch looks at the `name`, `link` and `tags` field of each link in the config to find a match.\n\nTo edit the search providers, toggle the edit mode, click on the edit icon on the search bar to add your desired search provider. You can add multiple search providers\n\n### Dragging your links/images/configs to add them\n\nYou cann now add/edit the links and background images of each of the cards by simply dragging that link or image from another browser window onto Hiccups link cards. The featured cards have two drop boxes, a link dropbox and image dropbox. To quickly update the background image, use the image dropbox.\n\nYou can also upload a config by dropping a config file onto any droppable card. Hiccup will be able to load it.\n\n### Using Edit mode\n\nThe edit mode can be activated using `Cmd/Ctrl + e` or the ✏️ icon on the bottom right of the screen. To exit the edit mode at any time use `Esc` or the commands used to start editing. The Edit mode lets you add, delete and edit links on the startpage.\n\nThe feaures currently supported are:\n\n- Add, edit and delete upto 4 featured cards\n- Add, edit and delete upto 4 categories\n- Add, edit and delete category links\n\nThese limits were place intentionally to\nFor more flexibility, you can directly edit the config using the config editor (described in the next section)\n\ne.g.:\n\n- Remove the category of featured section entirely\n- Add more than 4 categories or featured cards\n\n\u003e The `Edit mode` alters the config and if you ever wish to revert to the original config.json file, click the trash icon in the config editor to completely reset the config state.\n\n### Using Config\n\nSince this is a static website, all edits made are local and the new config must uploaded to a server from where the configs can be fetched. To make this process easier, Hiccup comes with a built in config manager. The config manager allows you to:\n\n- Load a config file from either URL or local file\n- Manage multiple configs (Preview, Select, Sync, Delete)\n- Download config file\n\nyou can also additionally share hiccup with a preloaded config using the `config` url parameter.\n\ne.g.\n\n```\nhttp://designedbyashw.in/test/hiccup?config=http://your-url.com/config.json\n```\n\n\u003e Since this is a CORS request, the server should allow requests from the source domain. Github Gists are an easy way to save remote config's\n\n#### Using with github gists\n\nTo save a config on github gists.\n\n1. Create the hiccup view you want and download the config.\n1. Copy the contents of the file to the gist\n1. Click Creat a **Public** Gist\n1. Copy the url and add `/raw` to the end. This is now your config URL\n\nShare the config with anyone to load in their instance of hiccup\n\n#### Migrations\n\nIf you were using an older version of Hiccup (\u003c v0.4.x), the config manager will automatically recover the old cached config and promt you to save it using the new version. download the recovered config and redistribute it as needed.\n\nAll the config information is stored in **LocalStorage** and never sent to a server anywhere!\n\n#### Config structure\n\nRefer to the [JSON Scheme file](src/modules/validateConfig/schema.json) for the latest schema.\n\n### Caching\n\nThe app now supports 4 caching strategies, these are useful if you dont want to frequently update your configs or run it completely offine\n\nStrategies:\n\n- `cache`: Use only the local cache to save and fetch data\n- `network`: Use only the network values and fail if you cannot get it\n- `cache-first`: If not found in the cache, fallback to the remote URL\n- `network-first`: (Default) If not found in the remote server, fallback to the cached value\n\nYou can set this value using the URL parameter `cache`\n\ne.g.\n\n```\nhttp://designedbyashw.in/test/hiccup?cache=network\n```\n\n### Docker\n\n**Building an image**\n\n```sh\ndocker build -t TAG .\n```\n\n**Running the image**\n\nedit the `./docker-compose.yml` file image to the `TAG` and run\n\n```\ndocker compose up\n```\n\nAnd visit the URL\n\n```\nhttp://localhost:8899\n```\n\n**Deploying to docker-hub**\n\nRun the release script `./release.sh`\n\n## Available Scripts for development\n\nIn the project directory, you can run:\n\n### `npm start`\n\nRuns the app in the development mode.\u003cbr /\u003e\nOpen [http://localhost:3000](http://localhost:3000) to view it in the browser.\n\nThe page will reload if you make edits.\u003cbr /\u003e\nYou will also see any lint errors in the console.\n\n### `npm test`\n\nLaunches the test runner in the interactive watch mode.\u003cbr /\u003e\nSee the section about [running tests](https://facebook.github.io/create-react-app/docs/running-tests) for more information.\n\n### `npm run cypress:run` and `npm run cypress:open`\n\nLaunches Cypress test suite\n\n### `npm run build`\n\nBuilds the app for production to the `build` folder.\u003cbr /\u003e\nIt correctly bundles React in production mode and optimizes the build for the best performance.\n\nThe build is minified and the filenames include the hashes.\u003cbr /\u003e\nYour app is ready to be deployed!\n\nSee the section about [deployment](https://facebook.github.io/create-react-app/docs/deployment) for more information.\n\n### `npm run eject`\n\n**Note: this is a one-way operation. Once you `eject`, you can’t go back!**\n\nIf you aren’t satisfied with the build tool and configuration choices, you can `eject` at any time. This command will remove the single build dependency from your project.\n\nInstead, it will copy all the configuration files and the transitive dependencies (webpack, Babel, ESLint, etc) right into your project so you have full control over them. All of the commands except `eject` will still work, but they will point to the copied scripts so you can tweak them. At this point you’re on your own.\n\nYou don’t have to ever use `eject`. The curated feature set is suitable for small and middle deployments, and you shouldn’t feel obligated to use this feature. However we understand that this tool wouldn’t be useful if you couldn’t customize it when you are ready for it.\n\n## Learn More\n\nYou can learn more in the [Create React App documentation](https://facebook.github.io/create-react-app/docs/getting-started).\n\nTo learn React, check out the [React documentation](https://reactjs.org/).\n\n### Code Splitting\n\nThis section has moved here: https://facebook.github.io/create-react-app/docs/code-splitting\n\n### Analyzing the Bundle Size\n\nThis section has moved here: https://facebook.github.io/create-react-app/docs/analyzing-the-bundle-size\n\n### Making a Progressive Web App\n\nThis section has moved here: https://facebook.github.io/create-react-app/docs/making-a-progressive-web-app\n\n### Advanced Configuration\n\nThis section has moved here: https://facebook.github.io/create-react-app/docs/advanced-configuration\n\n### Releasing the app\n\nTo release the app\n\n- Update the semver in the package.json\n- Update the `Readme.md` if new features have been added or breaking changes have been introduced\n- Run the `release.sh` script to:\n  - build the code and bundle it\n  - deploy the latest docker images\n  - bundle the built code to add as an `.zip` artifact to the github release\n- Push the code to Github and create a new release\n- Add the bundled zip as an artifact to the release and delete it locally\n\n### Deployment\n\nThis section has moved here: https://facebook.github.io/create-react-app/docs/deployment\n\n### `npm run build` fails to minify\n\nThis section has moved here: https://facebook.github.io/create-react-app/docs/troubleshooting#npm-run-build-fails-to-minify\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashwin-pc%2Fhiccup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fashwin-pc%2Fhiccup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashwin-pc%2Fhiccup/lists"}