posquit0/hugo-awesome-identity

Awesome Identity

Awesome Identity is a single-page Hugo theme to introduce yourself. Add a portrait, an introduction, serveral links, and you're set.

Features

• Extremely simple to use
• Responsive layout, supports any screen size
• Customizable theme colors
• Supports Google Analytics
• Live chat with Crisp integration

Getting Started

To use this theme you will need to have Hugo installed. If you don't have Hugo installed please follow Install Hugo.

Create a new Hugo site

hugo new site my-identity

Install the theme

If your site is under version control using git, the easiest way to install this theme is to add it as a submodule. Inside the directory of your Hugo site, run the following command.

git submodule add https://github.com/posquit0/hugo-awesome-identity themes/awesome-identity

Alternatively, you can clone the theme into your project.

git clone https://github.com/posquit0/hugo-awesome-identity themes/awesome-identity

Configure Hugo

Add the following line to config.toml to tell Hugo to use the theme.

theme = "awesome-identity"

Alternatively, you can tell Hugo to use the theme with the -t option.

hugo server -t awesome-identity

Run server for development

After installing the theme for the first time, generate the Hugo site.

hugo server

Now enter localhost:1313 in the address bar of your browser.

Configuration

Take a look in the exampleSite/ directory.

This directory contains an example config file and the content for the demo. It serves as an example setup for your documentation.

Copy the config.toml into the root directory of your website. Overwrite the existing config if necessary.

Contacts

You can put your own contacts such as e-mail address, or social media accounts. The contacts will be linked using icons from Font Awesome.

Currently, Awesome Identity supports: Email, GitHub, GitLab, Bitbucket, Twitter, Facebook, LinkedIn, Xing, Instagram, StackOverflow, Keybase, Medium, DEV, HackerRank, and Credly. Feel free to create Pull Request if you need other contact type.

## Contacts Configurations
[params.contacts]
  email = "[email protected]"
  github = "john.smith"
  gitlab = "john.smith"
  twitter = "john.smith"
  facebook = "john.smith"
  linkedin = "john.smith"
  instagram = "john.smith"
  stackoverflow = "7919458"
  keybase = "john.smith"
  medium = "john.smith"
  xing = "john.smith"
  credly = "john-smith"

Footer

## Footer Configurations
[params.footer]
  copyright = "© 2019 John Smith. [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/)."
  poweredBy = true

HTTP meta tags & OpenGraph

Google Analytics

Crisp

Colors

Dark Mode

The theme follows the visitor's system color scheme (prefers-color-scheme) automatically, and shows an on/off switch in the top-right corner so visitors can flip the scheme themselves. The visitor's choice is stored in localStorage and takes precedence on later visits.

To change the default scheme or hide the switch, set these parameters in your site config:

[params]
  # Default scheme: one of "auto" (default), "light", or "dark".
  appearance = "auto"
  # Set to false to hide the toggle switch.
  schemeToggle = true

Internationalization (i18n)

Update

If you have installed the theme as a git submodule, you can update the theme by issuing the following command inside your project directory.

git submodule update --remote --rebase

If you have cloned the theme, you can run git pull inside the theme directory.

Contributing

This project follows the Contributor Covenant Code of Conduct.

Bug Reports & Feature Requests

Please use the issue tracker to report any bugs or ask feature requests.

License

Provided under the terms of the MIT License.

Copyright © 2019-2026, Byungjin Park.

See Also

• Awesome CV - LaTeX template for your outstanding job application.