Changelog

All notable changes to the Boilerplate App template are documented here.

[Unreleased]

Initial release of the Boilerplate App template
Complete app structure with React Router v6 routing
FlowState Framework integration
- FlowstateAppContainer for app context
- FlowstateAppLayout for consistent layout
- Shared Header and Sidebar components
Plugin architecture for host container integration
- Plugin registration with AppPlugin interface
- Lazy loading support via dynamic imports
- Lifecycle hooks (onLoad, onUnload)
Dual-mode support
- Standalone mode for development with mock services
- Embedded mode for production in host container
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
Example pages
- HomePage with getting started content
- Users, Orgs, and Workspaces pages for standalone mode
Configuration files
- flowstate.json app manifest
- package.json with proper exports
- tsconfig.json with strict settings
- vite.config.mts using shared configuration
- tsup.config.ts for library builds

This changelog follows Keep a Changelog format.

When updating the boilerplate template:

Apps created from earlier versions are not automatically updated. Document migration steps for significant changes.

If you created an app before the 1.0.0 release:

Update framework imports:

// Old
import { AppContainer } from '@epicdm/flowstate-ui';

// New
import { FlowstateAppContainer } from '@epicdm/flowstate-app-framework';

Update Vite config to use shared configuration:

import { createViteConfig } from '@epicdm/flowstate-app-framework/config/vite';
export default createViteConfig({ port: 3210 });