idea.md

GRDN Theme for Hugo

A minimal, modern Hugo theme optimized for digital gardens and Obsidian-compatible note management.

Core Features

Content Management

• Flat URL structure regardless of folder hierarchy
• [x]All notes accessible under configurable base path (default: /notes/)
• Hover previews for internal links
• Backlinks section after content
• Wiki-style internal linking with [[wikilinks]]
• Graceful handling of broken links

Navigation & Discovery

• Modern, minimal design
• Dynamic filter bar with:
  • Full-text title search
  • Category filter with count indicators
  • Growth stage filter with count indicators
  • Configurable visibility of each filter component
• Real-time results updating
• Shareable URLs with filter state

Theme & Appearance

• Light/Dark mode support
• System preference detection
• Persistent theme choice
• Responsive design

Technical Architecture

URL Structure

• Content in notes/coffee/brewing.md → accessible at /notes/brewing
• Flat URL structure achieved through Hugo page bundles and custom taxonomy

Filter Implementation

• Client-side search
• Combined (AND) filtering logic
• Dynamic URL updates using History API
• Count indicators, configurable.

Future Enhancements

1. Filename conflict resolution
2. Transclusion support
3. Extended hover preview options
4. Advanced backlink features

Development Phases

1. Base theme setup and styling
2. Content rendering and markdown support
3. Wiki-links implementation
4. Filter-bar development
5. Theme switching
6. URL management
7. Performance optimization
8. Documentation

Technical Dependencies

• Hugo Extended (for SCSS)
• Fuse.js (for search)
• No other external dependencies

Notes

• All features configurable through hugo.toml
• No blog-specific features included
• Focus on performance and minimal JavaScript
• Mobile-first approach