VYASA
Vyāsa
←7 / 12→

Key FeaturesURL copied

🎨 Modern UIURL copied

  • Responsive Design: Works beautifully on all screen sizes with mobile-first approach
  • Three-Panel Layout: Posts sidebar, main content, and table of contents for easy navigation
  • Dark Mode: Automatic theme switching with localStorage persistence and instant visual feedback
  • HTMX Navigation: Fast, SPA-like navigation without full page reloads using hx-get, hx-target, and hx-push-url
  • Collapsible Folders: Organize posts in nested directories with chevron indicators and smooth expand/collapse
  • Sidebar Search: HTMX-powered filename search with results shown below the search bar (tree stays intact)
  • PDF Posts: PDFs show up in the sidebar and open inline in the main content area
  • Auto-Generated TOC: Table of contents automatically extracted from headings with scroll-based active highlighting
  • TOC Autoscroll + Accurate Highlights: Active TOC item stays in view and highlight logic handles duplicate headings
  • Inline Copy Button: Copy raw markdown from a button placed right next to the post title
  • Mobile Menus: Slide-in panels for posts and TOC on mobile devices with smooth transitions
  • Sticky Navigation: Navbar stays at top while scrolling, with mobile menu toggles
  • Active Link Highlighting: Current post and TOC section highlighted with blue accents
  • Auto-Reveal in Sidebar: Active post automatically expanded and scrolled into view when opening sidebar
  • Ultra-Thin Scrollbars: Custom styled 3px scrollbars that adapt to light/dark theme
  • Frosted Glass Sidebars: Backdrop blur and transparency effects on sidebar components
  • Theme Presets: Set theme_preset in .vyasa to use a bundled theme like serene-manuscript, kinetic-scholar, or ultra-soft
  • Theme Primary Override: Set theme_primary in .vyasa to swap the app accent color without editing CSS
Feature Category Config Key Description Default Env Override
FastHTML Integration Core — Built on FastHTML and Starlette for high-performance async rendering without a build step enabled —
Advanced Markdown Support Content — Footnotes as sidenotes, YouTube embeds, task lists, Mermaid + D2 diagrams, math notation, tabbed content, and more enabled —
Modern UI UI sidebars_open, layout_max_width, theme_preset, theme_primary Responsive three-panel layout with dark mode, HTMX navigation, frosted glass sidebars, configurable width, bundled theme presets, and optional primary override false, unset, serene-manuscript, forest green VYASA_SIDEBARS_OPEN, VYASA_THEME_PRESET, VYASA_THEME_PRIMARY
Interactive Diagrams Content [drawings_passwords] Zoomable, pannable Mermaid and D2 diagrams with fullscreen support and optional per-drawing password protection unprotected —
Auth & RBAC Security [google_oauth], [rbac] Google OAuth login with allowed domains/emails, role-based access control rules scoped per path disabled VYASA_GOOGLE_CLIENT_ID, VYASA_RBAC_ENABLED
Sidebar Navigation UI folder_tabs, folders_first, order, sort Collapsible file tree with tab grouping, custom entry ordering, sort direction, and smart abbreviation expansion false, name_asc —
Content Filtering Config ignore, include, show_hidden Fine-grained control over which files and folders appear in listings, with hidden-file visibility toggle all visible VYASA_SHOW_HIDDEN
Server Configuration Config host, port, title, root Bind address, deterministic port derived from working directory, site title, and content root path 127.0.0.1 VYASA_HOST, VYASA_PORT
Back to doc view