BashIt — The Retro-Modern Terminal Theme for Hugo
A distraction-free, lightning-fast static blog theme built entirely on the WebTUI CSS framework. Crafted for developers, sysadmins, and command-line purists who value keyboard-centric minimalism, authentic monospace aesthetics, and modern web performance.
Featured Documentation & Guides
BashIt Theme Guide: Core Setup & Components
The complete reference guide covering architecture, installation, configuration in hugo.toml, ASCII box borders, buttons, badges, tables, directory trees, progress meters, and popovers.
Extended Shortcodes: Diagrams, Charts & Maps
Interactive components ported from DoIt with terminal aesthetics: all 14 Admonition callouts, Mermaid diagrams, Apache ECharts, Leaflet/Mapbox, KaTeX math formulas, and alignment-enabled images.
Deploying the Terminal BBS: Cloudflare Workers + D1
Serverless, privacy-first comment system with zero trackers, zero ads, honeypot spam protection, and dual-mode Giscus GitHub Discussions support.
Palettes, Nerd Fonts & CSS Customization
Customizing Catppuccin Mocha, Gruvbox, Nord, and Everforest color schemes, Symbols Nerd Font typography, and extending styles via CSS @layer components.
WebTUI Social Cards & Media Embeds
Zero-tracker, privacy-first embeds for X (Twitter), Instagram, Dev.to, Daily.dev, GitHub repos, Reddit discussions, StackOverflow solutions, and YouTube CRT videos.
Why Choose BashIt?
Builds entire 60+ page sites in under 55 milliseconds via native Hugo Pipes asset bundling.
Ditch bloated Disqus ads. Switch seamlessly between your own Cloudflare D1 Terminal BBS or GitHub Giscus.
Buttons, popovers, badges, and boxes powered by CSS layers with zero client runtime weight.
Installation & Quickstart
You can add this repo as a submodule of your Hugo site directory:
git submodule add https://github.com/Debajyati/BashIt.git themes/BashIt
And later you can update the submodule in your site directory to the latest commit using this command:
git submodule update --remote --merge
Next, install dependencies and launch the Hugo development server:
# Install theme dependencies
cd themes/BashIt && npm install
# Run dev server from your site root
cd ../..
hugo server -D