Hugo Theme Tokyo Terminal

Hugo Theme Tokyo Terminal is a Hugo (static site generator) theme that renders a developer portfolio as a retro terminal interface using the Tokyo Night color palette and JetBrains Mono Nerd Font.

What is Hugo Theme Tokyo Terminal?

Hugo Theme Tokyo Terminal is an open-source Hugo theme created by rehan-hk to present a developer portfolio inside a terminal-style layout. You configure it through your site's hugo.toml file, providing a custom prompt string and social profile links, and Hugo builds a static site with an ASCII-art homepage and terminal aesthetics. The theme is distributed via git submodule and is licensed under the MIT License, so it can be freely reused and modified.

Key Features

• Terminal aesthetic — the entire layout mimics a retro terminal window rather than a conventional web page design.
• Tokyo Night color palette — syntax highlighting and UI colors follow the Tokyo Night scheme.
• JetBrains Mono Nerd Font — the theme is designed around this monospaced font for code-like readability.
• ASCII art on homepage — the landing page opens with ASCII art instead of a standard hero image or headline.
• Blinking cursor animation — the homepage includes a blinking cursor that reinforces the terminal effect.
• Configurable prompt — set your own shell prompt, like rehan@dev:~$, through the prompt parameter in hugo.toml.
• Social link integration — add GitHub, LinkedIn, or other profiles via the social parameter array.
• Simple Hugo setup — after adding the theme as a submodule, one line in hugo.toml switches your site to this theme.

Who is it for?

• Developer portfolio owners who want a technically themed site that stands out from typical resume pages.
• Hugo users who already have a Hugo site and prefer working with git submodules and hugo.toml configuration.
• Command-line enthusiasts who enjoy terminal culture and want that aesthetic reflected in their personal brand.
• Open-source contributors who want a minimal base they can extend, since the theme is described as 100% generic and configurable under an MIT license.

What can you do with Hugo Theme Tokyo Terminal?

• Developer portfolio: showcase your projects and profiles with a homepage that displays your chosen prompt and linked social accounts.
• Personal homepage: create a quirky, minimal presence that focuses attention on the ASCII art and your desired links.
• Terminal-theme experiments: adapt the color palette and typography to build other terminal-styled Hugo pages, since the theme is configurable.

How does Hugo Theme Tokyo Terminal work?

Installation is done inside an existing Hugo project by running git submodule add https://github.com/rehan-hk/hugo-tokyo-night-terminal-theme.git themes/hugo-theme-tokyo-terminal, then setting theme = "hugo-theme-tokyo-terminal" in hugo.toml. After that, configure your terminal prompt under [params] with prompt = "your-shell-prompt", and add [[params.social]] entries with name and url values to render links.

FAQ

Is Hugo Theme Tokyo Terminal free?

Yes, the theme is released under the MIT License, so you are free to use, copy, modify, and redistribute it for personal or commercial projects.

How do I install Hugo Theme Tokyo Terminal?

Run git submodule add https://github.com/rehan-hk/hugo-tokyo-night-terminal-theme.git themes/hugo-theme-tokyo-terminal from inside your Hugo project, then set theme = "hugo-theme-tokyo-terminal" in your hugo.toml.

How do I change the terminal prompt on the homepage?

Add a prompt setting under [params] in hugo.toml. The README example uses prompt = "rehan@dev:~$", and the value displays as the terminal prompt on the homepage.

How do I add social links to the theme?

In hugo.toml, create entries below [params] using the [[params.social]] array format, with name and url fields. GitHub and LinkedIn are the examples shown in the theme documentation.

Does the theme support syntax highlighting?

Yes, the theme features pure Tokyo Night syntax highlighting for code blocks.