Changelog

All notable changes to the Todo App are documented here.

[Unreleased]

Added

• Documentation site integration with .flowstate/docs/ structure
• Getting started guide for new users
• FAQ covering common questions
• Troubleshooting guide for common issues
• Workflow documentation for creating todos

Changed

• None

Fixed

• None

[1.0.0] - 2026-01-22

Added

• Initial release of the Todo App
• Core application structure with React Router v6 routing
• FlowState Framework integration
  • FlowstateAppContainer for app context
  • FlowstateAppLayout for consistent layout
  • Shared Header and Sidebar components
• Authentication integration
  • Auth-aware pages with sign-in prompts
  • User email/phone display in header
  • Session redirect handling
• Page scaffolds
  • TodoListPage - View all todos
  • NewTodoPage - Create new todo
  • TodoDetailPage - View/edit todo details
• Navigation components
  • Sidebar with "All Todos" and "New Todo" links
  • Header with app title and quick actions
• Plugin architecture for host container integration
  • Plugin registration with AppPlugin interface
  • Lazy loading support via dynamic imports
  • Lifecycle hooks (onLoad, onUnload)
• Database schema definition
  • TodoItem schema with id, title, description, priority, dueDate, completed
  • Indexes for userId, completed, dueDate, priority
• Development tooling
  • Vite dev server with Hot Module Replacement
  • tsup build configuration with ESM and CJS outputs
  • TypeScript strict mode configuration
• Styling
  • Tailwind CSS pre-configured
  • PostCSS and Autoprefixer setup

Technical Details

• Package: @epicdm/flowstate-app-todo
• Base Path: /todo
• Dev Port: 3211
• Build Output: ESM, CJS, TypeScript declarations, CSS

Development Status

The Todo App is currently in scaffold stage:

Upcoming Work

Version Format

This changelog follows Keep a Changelog format.

• Added for new features
• Changed for changes in existing functionality
• Deprecated for soon-to-be removed features
• Removed for now removed features
• Fixed for bug fixes
• Security for vulnerability fixes

Upgrade Notes

To 1.0.0

This is the initial release. No upgrade path required.

Future Upgrades

When upgrading between versions:

1. Review the changelog for breaking changes
2. Update the package in your host container
3. Test authentication flow
4. Verify todo data persistence
5. Check for deprecated features

Data Migration

Local Data

Todo data is stored in IndexedDB via RxDB. Schema changes in future versions may require migration:

• Migrations are handled automatically by RxDB
• Major schema changes will be documented here
• Always backup important data before major updates

Server Sync

When server replication is enabled:

• Client and server versions must be compatible
• Schema mismatches may cause sync failures
• Check release notes for sync compatibility

Known Issues

1.0.0

Reporting Issues

Found a bug? Please report it with:

1. Todo App version (check package.json)
2. Browser and version
3. Steps to reproduce
4. Expected vs actual behavior
5. Console errors (if any)
6. Screenshots (if helpful)

Submit issues through the FlowState support channel or monorepo issue tracker.