Skip to content

0.4.0 - Major Breaking Changes and View Mode Implementation

Major Breaking Changes and View Mode Implementation

Section titled “Major Breaking Changes and View Mode Implementation”

This release captures the major developments from August 27, 2025, including multiple breaking changes that fundamentally enhance the ArcAide experience.

Commit History
c3d72d5 - fix: UI Polish and Component Architecture Improvements (2025-08-27)
71a74b7 - feat!(ViewMode): Setup a pretty D&D Style View mode (2025-08-27)
6575018 - feat(editor): Can now crosslink between items in the editors (2025-08-27)
1c468e7 - fix!(auth): Auth is now accessible for all users (2025-08-27)
ae046ae - feat(SideBar): Better navigation now handled by sidebar (2025-08-27)
  • BREAKING: Complete UI overhaul with dual Edit/View mode system
  • View mode provides D&D-themed styling with parchment backgrounds
  • Edit mode maintains full functionality for content creation
  • Mode toggle persists across sessions and pages
  • BREAKING: Auth system now accessible for all users
  • Simplified authentication flow
  • Updated middleware for better performance
  • BREAKING: Parent/Child arc relationships now fully implemented
  • Database schema changes for arc relationships
  • New navigation patterns between related arcs
  • Custom typography using D&D 5e fonts (Bookinsanity, Mr Eaves Small Caps)
  • Parchment backgrounds for immersive content viewing
  • Single-column narrative flow in View Mode
  • Professional presentation suitable for sharing with players
  • Improved sidebar navigation system
  • Better organization of campaign content
  • Floating action buttons for mode switching
  • Crosslinking between items now fully functional
  • Rich text editor enhancements
  • Auto-save improvements
  • Auth performance optimized for non-protected routes
  • Database query optimizations
  • Component architecture improvements
  • Import structure refactored across entire codebase
  • Better separation of concerns
  • Improved documentation and comments throughout
  • All existing campaigns and arcs remain fully functional
  • New View Mode is optional - Edit Mode remains the default
  • Arc hierarchies can be applied to existing arcs without data loss
  • Updated component architecture requires reviewing import statements
  • New view mode components follow established patterns
  • Authentication middleware changes may affect local development setup
  • Component architecture improvements
  • Better visual consistency across the application
  • Enhanced user experience flows
  • Thing types and entity management improvements
  • Better search and discovery features
  • Improved content linking and cross-references

This release represents a major milestone in ArcAide’s evolution, providing a more immersive and professional tool for D&D campaign management while maintaining the powerful editing capabilities that make campaign creation efficient and enjoyable.

What Changed:

  • Introduced D&D-style view mode for immersive content presentation
  • Dual-mode interface: Edit mode for creation, View mode for consumption
  • Complete UI overhaul with authentic D&D theming and typography
  • Mode toggle replaces previous theme toggle functionality

Migration Required:

  • Remove references to dark mode/theme toggles
  • Update CSS classes to use new D&D theme system
  • Component styling now uses parchment backgrounds and D&D fonts in view mode

Related Commits:

  • 71a74b7 - feat!(ViewMode): Setup a pretty D&D Style View mode

What Changed:

  • Implemented hierarchical arc structure for complex campaign organization
  • Added parent/child relationships between arcs
  • Enhanced navigation with visual hierarchy display
  • Breaking changes to arc data structure and API responses

Migration Required:

  • Existing arcs may need parentArcId assignment for proper hierarchy
  • Arc API responses now include parent/child relationship data
  • Navigation components updated to handle hierarchical display

Related Commits:

  • 99a9566 - feat!(arc): Parent/Child arcs now setup

What Changed:

  • Auth system now accessible to all users (removed restrictions)
  • Simplified authentication flow
  • Breaking changes to auth middleware and protected route handling

Migration Required:

  • Review and update any custom auth restrictions
  • Update protected route configurations
  • Verify user access patterns match new open auth system

Related Commits:

  • 1c468e7 - fix!(auth): Auth is now accessible for all users

What Changed:

  • Complete search system overhaul with fuzzy matching
  • Full-text search with spell correction and ranking
  • Breaking changes to search API and result format
  • Enhanced search triggers and indexing

Migration Required:

  • Search results now use new format with ranking and highlights
  • Update any custom search implementations
  • Database migrations required for new FTS tables and triggers

Related Commits:

  • e9911ed - feat!(search): Fuzzy Search

What Changed:

  • Campaigns now use slug-based URLs instead of IDs
  • Breaking changes to all campaign-related API endpoints
  • URL structure completely changed

Migration Required:

  • All campaign URLs now use slugs (e.g., /campaign/my-campaign instead of /campaign/1)
  • Update any bookmarks or external links
  • API endpoints now expect campaign slugs instead of IDs

Related Commits:

  • 41cd6c9 - fix!(campaign): Using slug now
  • Rich text editor now supports internal linking between arcs and things
  • Wiki-style [[entity]] linking syntax
  • Automatic link resolution and navigation
  • Enhanced content connectivity

Related Commits:

  • 6575018 - feat(editor): Can now crosslink between items in the editors
  • Better navigation handling with improved sidebar
  • Quick access to campaign content
  • Streamlined navigation experience

Related Commits:

  • ae046ae - feat(SideBar): Better navigation now handled by sidebar
  • Campaign deletion functionality
  • Improved campaign lifecycle management

Related Commits:

  • 7e86115 - feat(campaign): Can now delete campaigns
  • Things can now be associated with arcs
  • Enhanced entity relationship management
  • Better content organization

Related Commits:

  • 1328f78 - feat(thing): Can now add things to Arcs, plus many more refactors
  • Dedicated thing viewing interface
  • Enhanced entity display and management

Related Commits:

  • e3bec80 - feat(thing): Can now view things
  • Better search functionality with improved triggers
  • More accurate and relevant search results

Related Commits:

  • 4b22836 - feat(Search): Better search
  • 8dc2314 - fix(search): Correct triggers
  • Added arcs and things to database schema
  • Improved data structure for complex campaigns

Related Commits:

  • af15c40 - feat(schema): Added arcs and things to schema
  • Campaign list display
  • Campaign creation interface
  • Better campaign management workflow

Related Commits:

  • 6e04d47 - feat(dashboard): Shows a list of campaigns, and can create campaigns
  • Major import path refactoring
  • Improved code organization and maintainability
  • Better separation of concerns

Related Commits:

  • 32f56a4 - refactor(imports): All imports across code now updated
  • Comprehensive documentation updates
  • Better code comments throughout application
  • Enhanced development guidelines

Related Commits:

  • 6ae5558 - docs(all): Added better comments throughout
  • 00774d6 - docs: Updated development guidelines
  • ad0e691 - documentation: Updated all docs, added better comments, and refactored the utils
  • Auth performance optimization for non-protected routes
  • Reduced overhead on public pages

Related Commits:

  • 65d6b5a - refactor(auth): Improved performance on non-protected routes
  • Homepage implementation
  • Documentation setup
  • Arcs with search integration
  • Template cloning and initial setup

Related Commits:

  • 2b50c97 - Homepage
  • 6182c05 - docs
  • 6e9d773 - Arcs with Search
  • 45257fe - cloned template
  • cf66965 - First commit
  • UI polish and component architecture refinements
  • Better visual hierarchy and spacing
  • Enhanced user experience across all interfaces

Related Commits:

  • c3d72d5 - fix: UI Polish and Component Architecture Improvements
  1. Update Import Paths

    Terminal window
    # Update editor component imports
    find src -name "*.tsx" -o -name "*.ts" | xargs sed -i 's|components/editor/|components/slate-handling/|g'
  2. Database Migrations

    Terminal window
    yarn migrate:db
  3. Remove Dark Mode References

    • Remove .dark: CSS classes
    • Update theme toggle components to mode toggle
    • Use new D&D theme CSS custom properties
  4. Update Campaign URLs

    • Replace ID-based URLs with slug-based URLs
    • Update any hardcoded campaign links
    • Test all campaign navigation
  1. Bookmark Updates

    • Update any bookmarked campaign URLs to use slugs
    • Campaign URLs now follow pattern: /dashboard/campaign/campaign-name
  2. Search Behavior

    • Search now provides fuzzy matching and spell correction
    • Results include relevance ranking and highlights
    • Faster and more accurate content discovery
  3. New Interface Modes

    • Use Edit mode for content creation and modification
    • Switch to View mode for reading and D&D-style presentation
    • Mode toggle available in bottom-right corner
  • 5 Breaking Changes requiring migration steps
  • 8 Major New Features enhancing functionality
  • Multiple Technical Improvements for performance and maintainability
  • Complete UI/UX Overhaul with D&D theming
  • Enhanced Developer Experience with better documentation and code organization

This represents the largest update to ArcAide since initial development, establishing the foundation for advanced campaign management features and providing a significantly enhanced user experience for D&D campaign organization.