SimpleAppState Documentation

SimpleAppState is a state-first state management library for Flutter.

This is designed for teams where not everyone is a state-management expert, prioritizing explicit ownership and misuse-resistant APIs to keep state behavior predictable and easy to reason about.

This documentation explains not only how to use the package, but also the design principles and trade-offs behind it.

If you are new to SimpleAppState, start with Getting Started. If you want to understand the design philosophy, read Core Concepts and Project Management and Design.

Contents

• Getting Started
  • Setup and First Run
  • Understanding the Basics
  • Scaling to a Real Project Structure
  • Common Mistakes
• Core Concepts
  • SimpleAppState
  • StateSlot
  • Value Semantics
  • Batch Updates
• State Models
  • RefAppState
  • RefSlot
  • When to use RefAppState
• Flutter Integration
  • Rebuild Model
  • SlotStatefulWidget
  • StateSlotBuilder
  • Flutter Common Mistakes
• Advanced Topics
  • Persistence and Restore
  • Undo and Redo
  • Testing
• Project Management and Design
  • Slot Boundaries and Ownership
  • State Builder Strategy
  • Performance Considerations
  • How we work
  • Using AI Prompts to Design a Screen
• Appendix
  • Glossary
• Notice
  • Trademarks