mirror of
https://github.com/pointfreeco/swift-composable-architecture.git
synced 2025-12-20 09:11:33 +01:00
307c851709
* New tutorial: Building SyncUps. * fix * clean up * wip * wip * wip * wip * wip --------- Co-authored-by: Stephen Celis <stephen@stephencelis.com>
95 lines
3.9 KiB
Plaintext
95 lines
3.9 KiB
Plaintext
@Tutorials(name: "Building SyncUps") {
|
|
@Intro(title: "Building SyncUps") {
|
|
The SyncUps application is a recreation of one of Apple's more interesting demo applications,
|
|
Scrumdinger. We recreate it from scratch using the Composable Architecture, with a focus on
|
|
domain modeling, controlling dependencies, and testability.
|
|
}
|
|
|
|
@Chapter(name: "What is SyncUps?") {
|
|
Let's start with a tour of the application we will be building. It's called SyncUps, and it's a
|
|
recreation of the Apple's Scrumdinger demo application.
|
|
|
|
@TutorialReference(tutorial: "doc:WhatIsSyncUps")
|
|
@Image(source: "chapter1.png")
|
|
}
|
|
|
|
@Chapter(name: "Lists of sync-ups") {
|
|
We will begin building the SyncUps app from scratch by implementing the feature that powers the
|
|
list of sync-ups. It starts out as a simple feature, but it will become increasingly complex as
|
|
the app evolves.
|
|
|
|
@TutorialReference(tutorial: "doc:ListsOfSyncUps")
|
|
@TutorialReference(tutorial: "doc:TestingListOfSyncUps")
|
|
@Image(source: "chapter2.png")
|
|
}
|
|
|
|
@Chapter(name: "New sync-up form") {
|
|
Let's build a new feature for editing the details of a sync-up in a form. This will allow us to
|
|
explore the binding tools the library provides, and we will add some complex logic around focus
|
|
in the form, and show how it is 100% testable.
|
|
|
|
@TutorialReference(tutorial: "doc:SyncUpForm")
|
|
@TutorialReference(tutorial: "doc:TestingSyncUpForm")
|
|
@Image(source: "chapter3.png")
|
|
}
|
|
|
|
@Chapter(name: "Presenting the sync-up form") {
|
|
We now have two features built, the sync-ups list and the sync-up form. These features do not
|
|
exist in isolation, but rather are meant to be integrated in a deep way. One should be able to
|
|
navigate to the sync-up form from the list view, enter the details of a new sync-up, and then
|
|
add that sync-up to the root list.
|
|
|
|
@TutorialReference(tutorial: "doc:PresentingSyncUpForm")
|
|
@TutorialReference(tutorial: "doc:TestingSyncUpFormPresentation")
|
|
@Image(source: "chapter4.png")
|
|
}
|
|
|
|
@Chapter(name: "Persisting sync-ups to disk") {
|
|
Applications typically need to persist data across application launches. The Composable
|
|
Architecture comes with tools to help you persist your application's data.
|
|
|
|
@TutorialReference(tutorial: "doc:PersistingSyncUps")
|
|
@Image(source: "chapter5.png")
|
|
}
|
|
|
|
@Chapter(name: "Sync-up detail") {
|
|
The next feature to build is the "detail" screen for a sync-up. This feature allows the user to
|
|
edit a sync-up, record a new meeting, see past recorded meetings, and even delete the
|
|
sync-up.
|
|
|
|
@TutorialReference(tutorial: "doc:SyncUpDetail")
|
|
@TutorialReference(tutorial: "doc:EditingAndDeletingSyncUp")
|
|
@TutorialReference(tutorial: "doc:TestingSyncUpDetail")
|
|
@Image(source: "chapter6.png")
|
|
}
|
|
|
|
@Chapter(name: "Navigating to sync-up detail") {
|
|
We now have a sync-up detail screen, but still no way to navigate to it from the rest of the
|
|
app. We want to be able to drill-down to the detail screen from the list screen.
|
|
|
|
@TutorialReference(tutorial: "doc:SyncUpDetailNavigation")
|
|
@TutorialReference(tutorial: "doc:MeetingNavigation")
|
|
@TutorialReference(tutorial: "doc:TestingNavigation")
|
|
@Image(source: "chapter7.png")
|
|
}
|
|
|
|
@Chapter(name: "Record meeting") {
|
|
The app is almost complete! But we have saved the most difficult feature for last: recording
|
|
a new meeting. This requires interfacing with two complex dependencies, a speech recognizer
|
|
and timer, and requires some subtle behavior that we are definitely going to want to get
|
|
test coverage on.
|
|
|
|
@TutorialReference(tutorial: "doc:RecordMeetingFeature")
|
|
@TutorialReference(tutorial: "doc:ImplementingTimer")
|
|
@TutorialReference(tutorial: "doc:ImplementingSpeechRecognizer")
|
|
@Image(source: "chapter8.png")
|
|
}
|
|
}
|
|
|
|
<!--
|
|
|
|
TODO: other things to consider
|
|
* analytics
|
|
*
|
|
-->
|