Awesome Identity

Awesome Identity is a single-page Hugo theme for building a personal introduction page with a portrait, a short bio, and social media links.

What is Awesome Identity?

Awesome Identity is a single-page Hugo theme that produces a personal landing page from simple configuration. It takes a Hugo site with a config file where you set your portrait, introduction text, theme colors, and contact handles, and outputs a responsive HTML page that introduces you. The theme is maintained by Byungjin Park on GitHub and is distributed under the MIT License. Building a site requires Hugo installed; the repo includes an exampleSite directory with a complete working configuration.

Key Features

• Single-page layout — Everything (portrait, intro, links) lives on one page; no blog or extra sections.
• Responsive layout — Supports any screen size, from phones to desktop monitors.
• Customizable theme colors — Change the accent colors from the site configuration.
• Google Analytics support — Built-in integration so you can add tracking without writing custom code.
• Crisp live chat — Optional Crisp chat widget can be enabled from configuration.
• Font Awesome contact icons — Supports 15 contact types including Email, GitHub, GitLab, Bitbucket, Twitter, Facebook, LinkedIn, Xing, Instagram, StackOverflow, Keybase, Medium, DEV, HackerRank, and Credly.
• Dark mode with toggle — Follows the visitor's system color scheme via prefers-color-scheme, and includes an on/off switch that stores the choice in localStorage.
• Internationalization (i18n) — The theme supports multilingual content.

Who is it for?

• Developers and students — Create a minimal personal homepage to link from GitHub profiles, resumes, or business cards.
• Job seekers — Quickly stand up a single-page introduction with a portrait, bio, and links to LinkedIn, GitHub, and other professional profiles.
• Anyone who wants a simple online presence — No blogging or portfolio pages needed; just a clean page to introduce yourself.

What can you do with Awesome Identity?

• Personal brand page: Publish a professional introduction with your photo, a tagline, and social links, deployable to Netlify (the repo includes a Netlify status badge).
• Static "about" page replacement: Use it as a lightweight alternative to a full portfolio site when all you need is a landing page.
• Hugo learning project: It serves as a minimal example of a Hugo theme; the exampleSite directory shows a complete setup you can copy.

How does Awesome Identity work?

Create a new Hugo site with the hugo new site command, install the theme either as a git submodule or by cloning it into themes/awesome-identity, set theme to awesome-identity in config.toml, and run hugo server to preview. The exampleSite directory contains a working config and content for the demo.

Pros and cons

• Pros: Extremely simple to set up, requires no JavaScript knowledge, includes built-in Google Analytics and Crisp integration, and follows system dark mode automatically.
• Cons: Single-page only — if you need a blog or multiple pages, this theme won't cover it.

Pricing

Awesome Identity is free and open source under the MIT License.

FAQ

Is Awesome Identity free?

Yes, Awesome Identity is released under the MIT License, so it is free to use, modify, and distribute. The source code is available on GitHub.

Does Awesome Identity support dark mode?

Yes, the theme follows the visitor's system color scheme automatically and shows an on/off switch in the top-right corner. The visitor's choice is stored in localStorage and takes precedence on later visits.

What contact types are supported?

Awesome Identity supports Email, GitHub, GitLab, Bitbucket, Twitter, Facebook, LinkedIn, Xing, Instagram, StackOverflow, Keybase, Medium, DEV, HackerRank, and Credly, with icons from Font Awesome.

How do I install Awesome Identity?

You need Hugo installed, then run hugo new site my-identity, add the theme as a git submodule (or clone it), set theme to awesome-identity in config.toml, and run hugo server. The full steps are in the README.

Can I customize the colors?

Yes, the theme colors are customizable from the site configuration. The config file in the exampleSite directory shows how to set them.