{"id":14981391,"url":"https://github.com/ragibson/blowfish-lite","last_synced_at":"2026-01-07T07:13:13.169Z","repository":{"id":250788999,"uuid":"835473114","full_name":"ragibson/blowfish-lite","owner":"ragibson","description":"Personal Website \u0026 Blog Theme for Hugo (~30x smaller than Blowfish with no loss in functionality)","archived":false,"fork":false,"pushed_at":"2024-07-29T23:40:08.000Z","size":10914,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-14T03:34:33.490Z","etag":null,"topics":["blog","blog-theme","blowfish","feature-rich","git-tutorial","git-workflow","hugo","hugo-blog-theme","hugo-theme","mit-license","responsive","theme","well-documented"],"latest_commit_sha":null,"homepage":"https://blowfish.page","language":"HTML","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/ragibson.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":"FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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},"funding":{"github":["nunocoracao"],"custom":["https://www.paypal.me/nunocoracao","https://www.buymeacoffee.com/nunocoracao"]}},"created_at":"2024-07-29T23:11:42.000Z","updated_at":"2024-07-30T00:41:14.000Z","dependencies_parsed_at":"2024-07-30T04:56:47.128Z","dependency_job_id":null,"html_url":"https://github.com/ragibson/blowfish-lite","commit_stats":null,"previous_names":["ragibson/blowfish-lite"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ragibson%2Fblowfish-lite","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ragibson%2Fblowfish-lite/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ragibson%2Fblowfish-lite/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ragibson%2Fblowfish-lite/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ragibson","download_url":"https://codeload.github.com/ragibson/blowfish-lite/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245921690,"owners_count":20694367,"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","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":["blog","blog-theme","blowfish","feature-rich","git-tutorial","git-workflow","hugo","hugo-blog-theme","hugo-theme","mit-license","responsive","theme","well-documented"],"created_at":"2024-09-24T14:03:29.326Z","updated_at":"2026-01-07T07:13:13.121Z","avatar_url":"https://github.com/ragibson.png","language":"HTML","readme":"# Blowfish\n\nBlowfish is designed to be a powerful, lightweight theme for [Hugo](https://gohugo.io). It's built using Tailwind CSS with a clean and minimalist design that prioritises to your content.\n\n![blowfish screenshot](/images/screenshot.png?raw=true)\n\nThis is a proof of concept that the Blowfish theme is at least ~30x larger than it needs to be.\nSee [\"Why the Hell Is This Git Repo So Large? And How to Trim It Down\"](https://ryanagibson.com/posts/shrink-git-repo/)\nfor more information.\n\n🌏 [Demo site](https://blowfish.page/)  \n📑 [Theme documentation](https://blowfish.page/docs/)  \n🐛 [Bug reports \u0026 issues](https://github.com/nunocoracao/blowfish/issues)  \n💡 [Questions \u0026 feature requests](https://github.com/nunocoracao/blowfish/discussions)\n\n## Features\n\n- Fully responsive layout built with Tailwind CSS 3.0\n- Multiple colour schemes (or fully customise your own)\n- Dark mode (forced on/off or auto-switching with user toggle)\n- Highly customisable configuration\n- Firebase integration to support dynamic data\n- Views count \u0026 like mechanism\n- Related articles\n- Multiple homepage layouts\n- Multiple authors\n- Series of articles\n- Date and weight based article sorting\n- Zen mode for article reading\n- Flexible with any content types, taxonomies and menus\n- Header and footer menus\n- Nested menus \u0026 sub-navigation menu\n- Scrollable table of contents\n- Multilingual content support including support for RTL languages\n- Ability to link to posts on third-party websites\n- Support for several shortcodes like Gallery, Timeline, GitHub cards, and Carousels\n- Buymeacoffee integration\n- Client-side site search powered by Fuse.js\n- Diagrams and visualisations using Mermaid\n- Charts using Chart.js\n- TypeIt integration\n- Youtube embeds with performance improvements\n- Mathematical notation using KaTeX\n- SVG icons from FontAwesome 6\n- Automatic image resizing using Hugo Pipes\n- Heading anchors, Tables of Contents, Code copy, Buttons, Badges and more\n- HTML and Emoji support in articles 🎉\n- SEO friendly with links for sharing to social media\n- Fathom Analytics and Google Analytics support\n- RSS feeds, Favicons and comments support\n- Advanced customisation using simple Tailwind colour definitions and styles\n- Optimised for performance and accessibility with perfect Lighthouse scores\n- Fully documented with regular updates\n\n---\n\n![blowfish logo](/logo.png?raw=true)\n\n## Documentation\n\nBlowfish has [extensive documentation](https://blowfish.page/docs/) that covers all aspects of the theme. Be sure to [read the docs](https://blowfish.page/docs/) to learn more about how to use the theme and its features.\n\n---\n\n## Installation\n\nBlowfish supports several installation methods - as a git submodule, a Hugo Module, or as a completely manual install.\n\nDetailed instructions for each method can be found in the [Installation](https://blowfish.page/docs/installation) docs. You should consult the documentation for the simplest setup experience. Below is a quick start guide using submodules if you are using git, or Hugo modules if you're already confident installing Hugo themes.\n\n### Quick start using Blowfish Tools\n\n\u003e **Note:** Ensure you have **Node.js**, **Git**, **Go** and **Hugo** installed, and that you have created a new Hugo project before proceeding.\n\nWe just launched a new CLI tool to help you get started with Blowfish. It will create a new Hugo project, install the theme and set up the theme configuration files for you. It's still in beta so please [report any issues you find](https://github.com/nunocoracao/blowfish-tools).\n\nInstall the CLI tool globally using npm (or other package manager):\n```shell\nnpm i -g blowfish-tools\n```\n\nThen run the command `blowfish-tools` to start an interactive run which will guide you through creation and configuration use-cases.\n```shell\nblowfish-tools\n```\n\nYou can also run the command `blowfish-tools new` to create a new Hugo project and install the theme in one go. Check the CLI help for more information.\n```shell\nblowfish-tools new mynewsite\n```\n\n### Quick start using git submodules\n\n\u003e **Note:** Ensure you have **Git**, **Go**, and **Hugo** installed, and that you have created a new Hugo project before proceeding.\n\n1. From your project directory, initialise git:\n\n   ```shell\n   git init\n   ```\n\n2. Configure Blowfish as a git submodule:\n\n   ```shell\n   git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish\n   ```\n\n3. In the root folder of your website, delete the `config.toml` file that was generated by Hugo. Copy the `*.toml` config files from the theme into your `config/_default/` folder.\n\n   You will find these theme config files in the Hugo cache directory, or download a copy from GitHub.\n\n4. Follow the [Getting Started](https://blowfish.page/docs/getting-started/) instructions to configure your website.\n\n### Quick start using Hugo\n\n\u003e **Note:** Ensure you have **Go** and **Hugo** installed, and that you have created a new Hugo project before proceeding.\n\n1. From your project directory, initialise Hugo Modules:\n\n   ```shell\n   hugo mod init github.com/\u003cusername\u003e/\u003crepo-name\u003e\n   ```\n\n2. Create `config/_default/module.toml` and add the following:\n\n   ```toml\n   [[imports]]\n   path = \"github.com/nunocoracao/blowfish/v2\"\n   ```\n\n3. Start your server using `hugo server` and the theme will be downloaded automatically.\n\n4. In the root folder of your website, delete the `config.toml` file that was generated by Hugo. Copy the `*.toml` config files from the theme into your `config/_default/` folder.\n\n   \u003e **Note:** Do not overwrite the `module.toml` file you created above!\n\n   You will find these theme config files in the Hugo cache directory, or download a copy from GitHub.\n\n5. Follow the [Getting Started](https://blowfish.page/docs/getting-started/) instructions to configure your website.\n\n### Installing theme updates\n\nAs new releases are posted, you can update the theme using Hugo. Simply run `hugo mod get -u` from your project directory and the theme will automatically update to the latest release.\n\nDetailed [update instructions](https://blowfish.page/docs/installation/#installing-updates) are available in the docs.\n\n---\n\n## Contributing\n\nBlowfish is expected to evolve over time. I intend to keep adding features and making changes as required.\n\nFeel free to get in touch with any issues or suggestions for new features you'd like to see.\n\n- 🐛 **Bug reports \u0026 issues:** Use [GitHub Issues](https://github.com/nunocoracao/blowfish/issues)\n- 💡 **Ideas for new features:** Open a discussion on [GitHub Discussions](https://github.com/nunocoracao/blowfish/discussions)\n- 🙋‍♀️ **General questions:** Head to [GitHub Discussions](https://github.com/nunocoracao/blowfish/discussions)\n\nIf you're able to fix a bug or implement a new feature, I welcome PRs for this purpose. Learn more in the [contributing guidelines](/CONTRIBUTING.md).","funding_links":["https://github.com/sponsors/nunocoracao","https://www.paypal.me/nunocoracao","https://www.buymeacoffee.com/nunocoracao"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fragibson%2Fblowfish-lite","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fragibson%2Fblowfish-lite","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fragibson%2Fblowfish-lite/lists"}