https://github.com/ronstorm/tca-kit
A lightweight state-management library inspired by TCA principles.
https://github.com/ronstorm/tca-kit
clean-code composable-architecture state-management swift tca
Last synced: 8 months ago
JSON representation
A lightweight state-management library inspired by TCA principles.
- Host: GitHub
- URL: https://github.com/ronstorm/tca-kit
- Owner: ronstorm
- License: mit
- Created: 2025-09-12T00:54:43.000Z (9 months ago)
- Default Branch: master
- Last Pushed: 2025-09-16T05:42:09.000Z (9 months ago)
- Last Synced: 2025-10-21T09:54:29.386Z (8 months ago)
- Topics: clean-code, composable-architecture, state-management, swift, tca
- Language: Swift
- Homepage:
- Size: 136 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: Docs/README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# TCAKit Documentation
Welcome to the TCAKit documentation! This guide will help you understand and use TCAKit effectively.
## Quick Start
1. **[Installation](installation.md)** - Add TCAKit to your project
2. **[Basic Usage](basic-usage.md)** - Your first TCAKit app
3. **[Examples](../Examples/)** - Ready-to-run example apps
## Core Concepts
### [Store](store.md)
The central component that manages state and handles actions.
### [Reducer](reducer.md)
Pure functions that handle actions and update state.
### [Effect](effect.md)
Represents async side effects with cancellation support.
### [Dependencies](dependencies.md)
Environment-based dependency injection for services.
### [WithStore](withstore.md)
SwiftUI helper for ergonomic store usage in views.
### [TestStore](teststore.md)
Testing utility with fluent assertions and transcripts.
### [CombineBridge](combine-bridge.md)
Seamless integration between Combine publishers and TCAKit effects.
## Advanced Topics
### [SwiftUI Integration](swiftui-integration.md)
Best practices for using TCAKit with SwiftUI.
## Examples
Ready-to-run examples showcasing TCAKit patterns:
- **[BasicCounter](../Examples/BasicCounter/)** - Start here
- **[TodoList](../Examples/TodoList/)** - Intermediate patterns
- **[WeatherApp](../Examples/WeatherApp/)** - Advanced patterns
## Need Help?
- [GitHub Issues](https://github.com/ronstorm/tca-kit/issues)
- [GitHub Discussions](https://github.com/ronstorm/tca-kit/discussions)