dockerbobw/flatnotes-enhanced repository overview

⁠Flatnotes-Enhanced

Flatnotes-Enhanced elevates the original Flatnotes into a powerful, customizable, and user-friendly note-taking application. Designed for professionals and enthusiasts, it offers advanced organization, visual customization, and a seamless user experience—all while maintaining simplicity and performance.

⁠Quick Start

docker pull dockerbobw/flatnotes-enhanced:latest
docker run -d \
  --name flatnotes-enhanced \
  -p 8080:8080 \
  -v ./data:/data \
  -e "FLATNOTES_AUTH_TYPE=password" \
  -e "FLATNOTES_USERNAME=user" \
  -e "FLATNOTES_PASSWORD=changeMe!" \
  dockerbobw/flatnotes-enhanced:latest

⁠Environment Variables

⁠Features

• 📁 Folder sidebar with drag & drop
• 🏷️ Tag sidebar with color chips
• 👁️ Note popup preview
• 🎨 Visual customization (callouts, headers, tables, quotes)
  • Custom Branding – rename your instance, set a custom accent color, upload a logo and favicon
  • Theme Selector – 16 predefined color themes (Dracula, Catppuccin, Gruvbox, Nord, Solarized, Tokyo Night, One)
• 📝 Enhanced editor (highlights, search/replace, autocomplete)
• 📎 File attachments with PDF preview
• 🗑️ Trash and archive system
• 💾 Preferences Backup & Restore (Your preferences (colors, callouts, tag settings,etc.) are automatically backed up daily)
• 💾 Multi-Instance Support
• 🔐 TOTP 2FA support
• 📴 Progressive Web App (PWA) – offline read-only access, installable as standalone app
• 🔍 Saved Searches – Save and reuse search queries with one click from the sidebar
• 🔗 Shared Notes – Share any note via a secure, token-based link. Choose Read only or Can edit permissions, set an expiry (7/30/90 days or never), and optionally add a password for extra protection.
  • Share Admin Page – View and manage all active share links across all notes in one place.
  • Visual Indicators – The Share button turns orange when a note has active links; a "Shared:" timestamp appears in the note footer.
• 🔐 Single Sign-On (SSO) – Log in using OIDC/OAuth2 providers: Google, GitHub, PocketID, Authelia, Authentik, Keycloak, and more

⁠Documentation

Full documentation and source code: https://github.com/BobWs/flatnotes-enhanced⁠

⁠📝 Changelog

⁠v1.18.0 (2026-09-26)

• Theme Selector – 16 predefined color themes (Dracula, Catppuccin, Gruvbox, Nord, Solarized, Tokyo Night, One)

⁠v1.17.0 (2026-09-22)

• Custom Branding – Name, Accent Color, Logo & Favicon

⁠v1.16.1 (2026-09-19)

• Bug Fix: Copy button on code blocks no longer adds a trailing newline

⁠v1.16.0 (2026-09-13)

• Copy Button for Code Blocks – one-click copying from any code block

⁠v1.15.0 (2026-09-12)

• Substring Search by Default – Opt-in toggle for automatic substring matching. Type alph to find "alpha" without typing * manually.

⁠v1.14.2 (2026-09-05)

• Bug fixes: Clipboard fallback for HTTP + SSO independent OIDC/OAuth configuration

⁠v1.14.1 (2026-09-02)

• Docker secrets support (security enhancement)

⁠v1.14.0 (2026-09-01)

• Single Sign-On (SSO) – OIDC/OAuth2 authentication support (Google, GitHub, PocketID, Authelia, Authentik, Keycloak)

⁠v1.13.1 (2026-08-16)

• Dependency updates & build tooling modernisation (uv, Node.js, Python 3.13)

⁠v1.13.0 (2026-08-10)

• Shared Notes – token-based note sharing with read/write permissions, passwords, expiry, admin page, and activity tracking

⁠v1.12.1 (2026-08-02)

• Hot Fix: Remove public TOTP QR code from login screen

⁠v1.12.0 (2026-07-31)

• Hide Frontmatter – Opt-in toggle to remove YAML/TOML metadata blocks (---...---) from view and preview. Perfect for notes imported from Obsidian, Markleaf, and other tools.

⁠v1.11.0 (2026-07-22)

• Showcase Mode – Transform your instance into a public read-only note viewer (FLATNOTES_SEARCH_DISABLED=true). Perfect for sharing curated notes with the world.

⁠v1.10.0 (2026-07-09)

• Saved Searches – Save and reuse search queries with one click from the sidebar
• Title Z–A Sort – Sort by title in descending order (alphabetical Z to A)
• NavBar spacing reduction – Reclaimed 40px of vertical space at the top of the app
• Fixed Tag Pollution – Hex colors, port numbers, and config comments no longer appear as tags in the sidebar

⁠v1.9.0 (2026-06-25)

• Customisable Date Formatting – choose locale and style (Short/Medium/Long)

⁠v1.8.0 (2026-06-21)

• Progressive Web App (PWA) – Install Flatnotes-Enhanced as a standalone app and access previously viewed notes offline (read-only)

⁠v1.7.2 (2026-06-11)

• Non-ASCII character support for usernames and passwords (umlauts, accented characters)

⁠v1.7.1 (2026-05-31)

• Bug fix: Backup list now shows clearer date timestamps with file size and helpful tooltips
• Bug fix: Version check now uses Docker Hub API (primary) with GitHub fallback – more reliable, no more false "Offline" due to rate limits

⁠v1.7.0 (2026-05-30)

• Redesigned Archive Page – Search, sort, and filter archived notes (matching the Attachments page design)
• New Maintenance Tab – Trash manager, content summary, and system info in a clean two-column layout
• Preferences Backup & Restore – Automatic daily backups, manual backups, and restore with safety confirmation
• Live Version Check – Automatic update detection shows when a new release is available
• Settings Page Refactor – Split into dedicated components for faster loading and easier maintenance

⁠v1.6.3 (2026-05-25)

• Bug fix: Expand All now expands all nested folder and tag levels; individual expand/collapse works before AND after using Expand/Collapse All
• Bug fix: Header colors and font (H1–H6) now correctly respect your Settings preferences – disabling headers reverts to default theme color and Poppins font

⁠v1.6.2 (2026-05-24)

• Consistent Default Sorting – All Notes respects your preference
• All "All Notes" entry points now respect your saved sort preference from Settings → Preferences → Default note sort.

⁠v1.6.1 (2026-05-21)

• Bug Fix – Title truncation in editor header
• Fixed: Long note titles were being cut off without an ellipsis (…), and the folder breadcrumb competed for space with the action buttons (Pin, Archive, Trash, Edit/Save).

⁠v1.6.0 (2026-05-18)

• Note Views – Choose your preferred reading width: Normal (999px), Wide (1400px), or Full Screen

⁠v1.5.1 (2026-05-14)

• Bug Fixes – Case-insensitive attachments & Archive folder scanning

⁠v1.5.0 (2026-05-10)

• Wikilink Popup Modal – Link notes without typing

⁠v1.4.2 (2026-05-09)

• Bug Fix: Note switching while editing
• Fixed: Switching to a different note while the editor was open caused title mismatches, duplicate note errors, and a broken editor state.

⁠v1.4.1 (2026-05-08)

• Attachment System Overhaul + Attachments Page redesign (search, filter, sort)

⁠v1.4.0 (2026-05-04)

• Custom Home Note – Start where your work begins
• Go to Settings → Preferences and scroll to Custom home note:
• Toggle "Custom home note" ON
• Enter the exact note title — for notes in folders, use the full path (e.g. Work/Weekly)
• Click Open to verify the note exists
• Click Save preferences That's it. The Home button now takes you straight there.

⁠v1.3.0 (2026-05-03)

• Multi-Instance Support – Run multiple Flatnotes on the same server
• Each domain gets its own isolated authentication token
• No session bleed, no cache conflicts
• Full documentation in MULTI_INSTANCE.md⁠

⁠v1.2.0 (2026-05-02)

• current stable release ( Button Label Toggle & UI Polish)

⁠v1.1.0 (2026-04-29)

• current stable release (duplicate notes + bulk delete)

⁠v1.0.2 (2026-04-26)

• (multi-arch: linux/amd64 + linux/arm64) support

⁠v1.0.1 (2026-04-25)

• Fixed: Code block background color in note popup preview for light theme.

⁠v1.0.0 (2026-04-12)

• Initial release of Flatnotes-Enhanced.

Built with ❤️ for better note-taking.

⭐ Enjoying Flatnotes-Enhanced? Consider giving it a star on GitHub to help others discover it.