• Minimalist design
• Fully responsive
• Card design
• Experience timeline
• Project cards
• Dark theme
• Post categories and topics
• Syntax highlighting
• Analytics (Cloudflare & GoatCounter)
• PWA

• Hugo v0.111.0 (or later) - With extended feature set
• Golang v1.18 (or later)
• Node LTS version (v16 or later)

Initialize Hugo modules in your repository. This will create a go.mod file.

hugo mod init github.com/<username>/<repo_name>

In your hugo.yaml file's module section, add a new import for the Aurora theme:

Info: Optionally, you can enable deep merge to make use of the defaults

# hugo.yaml
_merge: deep

module:
  imports:
  - path: github.com/nszilard/aurora

Finally, fetch the latest version:

hugo mod get -u github.com/nszilard/aurora
hugo mod tidy

In order to minimize CSS files, you can use @fullhuman/postcss-purgecss and postcss-cli packages.

npm install @fullhuman/postcss-purgecss postcss-cli

Next you will have to configure purge-css by adding the following file at the root of your repo:

// File: postcss.config.js
const purgecss = require('@fullhuman/postcss-purgecss')({
  content: ['./hugo_stats.json'],
  safelist: [],
  defaultExtractor: (content) => {
    let els = JSON.parse(content).htmlElements;
    return els.tags.concat(els.classes, els.ids);
  }
});

module.exports = {
  plugins: [
    purgecss
  ]
};

Aurora supports optional integration with Cloudflare Web Analytics and GoatCounter. Both services are privacy-friendly and provide valuable insights about your site traffic.

Add the following to your hugo.yaml file:

# hugo.yaml
params:
  analytics:
    enabled: true
    # For using Cloudflare Web Analytics
    cloudflare:
      code: 'your-cloudflare-analytics-token'
    # For using GoatCounter
    goatCounter:
      code: 'your-site-code'

Both Cloudflare Web Analytics and GoatCounter are privacy-focused:

• ✅ No cookies
• ✅ GDPR compliant
• ✅ No personal data collection
• ✅ Lightweight and fast