ai-flow-dev 2.1.3 → 2.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +25 -38
- package/dist/cli.js +68 -46
- package/dist/cli.js.map +1 -1
- package/package.json +5 -5
- package/prompts/backend/flow-build-phase-0.md +31 -63
- package/prompts/backend/flow-build-phase-1.md +9 -17
- package/prompts/backend/flow-build-phase-10.md +199 -585
- package/prompts/backend/flow-build-phase-2.md +152 -86
- package/prompts/backend/flow-build-phase-3.md +108 -68
- package/prompts/backend/flow-build-phase-4.md +5 -8
- package/prompts/backend/flow-build-phase-5.md +39 -12
- package/prompts/backend/flow-build-phase-6.md +29 -8
- package/prompts/backend/flow-build-phase-7.md +120 -40
- package/prompts/backend/flow-build-phase-8.md +28 -65
- package/prompts/backend/flow-build-phase-9.md +267 -1298
- package/prompts/backend/flow-build.md +881 -957
- package/prompts/backend/flow-dev-commit.md +27 -50
- package/prompts/backend/flow-dev-feature.md +1929 -2017
- package/prompts/backend/flow-dev-fix.md +936 -964
- package/prompts/backend/flow-dev-refactor.md +672 -701
- package/prompts/backend/flow-dev-review.md +356 -389
- package/prompts/backend/flow-dev-work.md +1066 -1118
- package/prompts/backend/flow-docs-sync.md +20 -196
- package/prompts/frontend/flow-build-phase-0.md +503 -484
- package/prompts/frontend/flow-build-phase-1.md +445 -433
- package/prompts/frontend/flow-build-phase-2.md +910 -957
- package/prompts/frontend/flow-build-phase-3.md +692 -664
- package/prompts/frontend/flow-build-phase-4.md +478 -463
- package/prompts/frontend/flow-build-phase-5.md +488 -467
- package/prompts/frontend/flow-build-phase-6.md +571 -550
- package/prompts/frontend/flow-build-phase-7.md +560 -592
- package/prompts/frontend/flow-build-phase-8.md +17 -42
- package/prompts/frontend/flow-build.md +457 -503
- package/prompts/frontend/flow-docs-sync.md +14 -35
- package/prompts/mobile/flow-build-phase-0.md +104 -97
- package/prompts/mobile/flow-build-phase-1.md +137 -122
- package/prompts/mobile/flow-build-phase-2.md +123 -130
- package/prompts/mobile/flow-build-phase-3.md +144 -149
- package/prompts/mobile/flow-build-phase-4.md +140 -132
- package/prompts/mobile/flow-build-phase-5.md +70 -70
- package/prompts/mobile/flow-build-phase-6.md +136 -134
- package/prompts/mobile/flow-build-phase-7.md +24 -58
- package/prompts/mobile/flow-build-phase-8.md +17 -42
- package/prompts/mobile/flow-build.md +47 -97
- package/prompts/mobile/flow-docs-sync.md +13 -32
- package/prompts/shared/mermaid-guidelines.md +106 -0
- package/prompts/shared/scope-levels.md +126 -0
- package/prompts/shared/story-points.md +65 -0
- package/prompts/shared/task-format.md +86 -0
- package/templates/AGENT.template.md +194 -15
- package/templates/backend/README.template.md +2 -32
- package/templates/backend/ai-instructions.template.md +2 -32
- package/templates/backend/copilot-instructions.template.md +2 -22
- package/templates/backend/docs/api.template.md +89 -20
- package/templates/backend/docs/architecture.template.md +165 -53
- package/templates/backend/docs/business-flows.template.md +7 -14
- package/templates/backend/docs/code-standards.template.md +2 -38
- package/templates/backend/docs/contributing.template.md +2 -16
- package/templates/backend/docs/data-model.template.md +125 -21
- package/templates/backend/docs/operations.template.md +179 -50
- package/templates/backend/docs/testing.template.md +2 -42
- package/templates/backend/project-brief.template.md +2 -28
- package/templates/backend/specs/configuration.template.md +2 -14
- package/templates/backend/specs/security.template.md +2 -32
- package/templates/frontend/README.template.md +2 -18
- package/templates/frontend/ai-instructions.template.md +2 -20
- package/templates/frontend/docs/api-integration.template.md +12 -30
- package/templates/frontend/docs/components.template.md +2 -28
- package/templates/frontend/docs/error-handling.template.md +11 -27
- package/templates/frontend/docs/operations.template.md +8 -18
- package/templates/frontend/docs/performance.template.md +8 -18
- package/templates/frontend/docs/pwa.template.md +8 -18
- package/templates/frontend/docs/state-management.template.md +2 -28
- package/templates/frontend/docs/styling.template.md +2 -26
- package/templates/frontend/docs/testing.template.md +2 -28
- package/templates/frontend/project-brief.template.md +2 -16
- package/templates/frontend/specs/accessibility.template.md +8 -18
- package/templates/frontend/specs/configuration.template.md +2 -24
- package/templates/frontend/specs/security.template.md +10 -24
- package/templates/fullstack/README.template.md +17 -47
- package/templates/fullstack/ai-instructions.template.md +17 -45
- package/templates/fullstack/project-brief.template.md +16 -42
- package/templates/fullstack/specs/configuration.template.md +16 -42
- package/templates/mobile/README.template.md +11 -29
- package/templates/mobile/ai-instructions.template.md +11 -27
- package/templates/mobile/docs/app-store.template.md +11 -29
- package/templates/mobile/docs/architecture.template.md +14 -38
- package/templates/mobile/docs/native-features.template.md +16 -44
- package/templates/mobile/docs/navigation.template.md +9 -23
- package/templates/mobile/docs/offline-strategy.template.md +10 -26
- package/templates/mobile/docs/permissions.template.md +9 -23
- package/templates/mobile/docs/state-management.template.md +12 -32
- package/templates/mobile/docs/testing.template.md +14 -38
- package/templates/mobile/project-brief.template.md +12 -30
- package/templates/mobile/specs/build-configuration.template.md +10 -26
- package/templates/mobile/specs/deployment.template.md +9 -23
|
@@ -1,18 +1,14 @@
|
|
|
1
1
|
# App Store Configuration
|
|
2
2
|
|
|
3
3
|
> App Store and Play Store deployment guide for {{PROJECT_NAME}}
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
4
|
+
---
|
|
7
5
|
## 📱 App Stores
|
|
8
6
|
|
|
9
7
|
**Target Stores:** {{TARGET_STORES}}
|
|
10
8
|
|
|
11
9
|
- **iOS:** {{IOS_STORE_ENABLED}}
|
|
12
10
|
- **Android:** {{ANDROID_STORE_ENABLED}}
|
|
13
|
-
|
|
14
|
-
---
|
|
15
|
-
|
|
11
|
+
---
|
|
16
12
|
## 🍎 Apple App Store
|
|
17
13
|
|
|
18
14
|
### App Store Connect Setup
|
|
@@ -47,9 +43,7 @@
|
|
|
47
43
|
**Demo Account:** {{IOS_DEMO_ACCOUNT}}
|
|
48
44
|
|
|
49
45
|
**Review Notes:** {{IOS_REVIEW_NOTES}}
|
|
50
|
-
|
|
51
|
-
---
|
|
52
|
-
|
|
46
|
+
---
|
|
53
47
|
## 🤖 Google Play Store
|
|
54
48
|
|
|
55
49
|
### Play Console Setup
|
|
@@ -81,9 +75,7 @@
|
|
|
81
75
|
### Feature Graphic
|
|
82
76
|
|
|
83
77
|
**Size:** 1024x500 pixels
|
|
84
|
-
|
|
85
|
-
---
|
|
86
|
-
|
|
78
|
+
---
|
|
87
79
|
## 🚀 Deployment Process
|
|
88
80
|
|
|
89
81
|
### iOS Deployment
|
|
@@ -93,17 +85,13 @@
|
|
|
93
85
|
### Android Deployment
|
|
94
86
|
|
|
95
87
|
{{ANDROID_DEPLOYMENT_PROCESS}}
|
|
96
|
-
|
|
97
|
-
---
|
|
98
|
-
|
|
88
|
+
---
|
|
99
89
|
## 🔄 Release Strategy
|
|
100
90
|
|
|
101
91
|
**Release Strategy:** {{RELEASE_STRATEGY}}
|
|
102
92
|
|
|
103
93
|
{{RELEASE_STRATEGY_DESCRIPTION}}
|
|
104
|
-
|
|
105
|
-
---
|
|
106
|
-
|
|
94
|
+
---
|
|
107
95
|
## 📊 Beta Testing
|
|
108
96
|
|
|
109
97
|
**Beta Testing Strategy:** {{BETA_TESTING_STRATEGY}}
|
|
@@ -111,17 +99,13 @@
|
|
|
111
99
|
**iOS:** {{IOS_BETA_TESTING}}
|
|
112
100
|
|
|
113
101
|
**Android:** {{ANDROID_BETA_TESTING}}
|
|
114
|
-
|
|
115
|
-
---
|
|
116
|
-
|
|
102
|
+
---
|
|
117
103
|
## 🔐 Code Signing
|
|
118
104
|
|
|
119
105
|
**Code Signing Strategy:** {{CODE_SIGNING_STRATEGY}}
|
|
120
106
|
|
|
121
107
|
{{CODE_SIGNING_DESCRIPTION}}
|
|
122
|
-
|
|
123
|
-
---
|
|
124
|
-
|
|
108
|
+
---
|
|
125
109
|
## 📈 Monitoring
|
|
126
110
|
|
|
127
111
|
**Analytics:** {{ANALYTICS_TOOL}}
|
|
@@ -129,9 +113,7 @@
|
|
|
129
113
|
**Crash Reporting:** {{CRASH_REPORTING_TOOL}}
|
|
130
114
|
|
|
131
115
|
**App Store Analytics:** {{STORE_ANALYTICS_ENABLED}}
|
|
132
|
-
|
|
133
|
-
---
|
|
134
|
-
|
|
116
|
+
---
|
|
135
117
|
## ✅ Checklist
|
|
136
118
|
|
|
137
119
|
### Pre-Release
|
|
@@ -156,8 +138,8 @@
|
|
|
156
138
|
- [ ] Monitor user reviews
|
|
157
139
|
- [ ] Monitor analytics
|
|
158
140
|
- [ ] Plan updates
|
|
141
|
+
---
|
|
142
|
+
**Last Updated:** {{LAST_UPDATED}}
|
|
159
143
|
|
|
160
|
-
---
|
|
161
144
|
|
|
162
|
-
**Last Updated:** {{LAST_UPDATED}}
|
|
163
145
|
|
|
@@ -1,9 +1,7 @@
|
|
|
1
1
|
# Architecture Guide
|
|
2
2
|
|
|
3
3
|
> System architecture for {{PROJECT_NAME}}
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
4
|
+
---
|
|
7
5
|
## 🏗️ Architecture Overview
|
|
8
6
|
|
|
9
7
|
**Architecture Pattern:** {{ARCHITECTURE_PATTERN}}
|
|
@@ -11,37 +9,27 @@
|
|
|
11
9
|
**Framework:** {{FRAMEWORK}} {{FRAMEWORK_VERSION}}
|
|
12
10
|
|
|
13
11
|
**Platforms:** {{PLATFORMS}}
|
|
14
|
-
|
|
15
|
-
---
|
|
16
|
-
|
|
12
|
+
---
|
|
17
13
|
## 📐 Architecture Layers
|
|
18
14
|
|
|
19
15
|
{{ARCHITECTURE_LAYERS_DESCRIPTION}}
|
|
20
|
-
|
|
21
|
-
---
|
|
22
|
-
|
|
16
|
+
---
|
|
23
17
|
## 📁 Folder Structure
|
|
24
18
|
|
|
25
19
|
```
|
|
26
20
|
{{FOLDER_STRUCTURE}}
|
|
27
21
|
```
|
|
28
|
-
|
|
29
|
-
---
|
|
30
|
-
|
|
22
|
+
---
|
|
31
23
|
## 🔄 Data Flow
|
|
32
24
|
|
|
33
25
|
{{DATA_FLOW_DESCRIPTION}}
|
|
34
|
-
|
|
35
|
-
---
|
|
36
|
-
|
|
26
|
+
---
|
|
37
27
|
## 🧩 Component Architecture
|
|
38
28
|
|
|
39
29
|
**Component Pattern:** {{COMPONENT_PATTERN}}
|
|
40
30
|
|
|
41
31
|
{{COMPONENT_ARCHITECTURE_DESCRIPTION}}
|
|
42
|
-
|
|
43
|
-
---
|
|
44
|
-
|
|
32
|
+
---
|
|
45
33
|
## 🔌 API Integration
|
|
46
34
|
|
|
47
35
|
**API Style:** {{API_STYLE}}
|
|
@@ -49,9 +37,7 @@
|
|
|
49
37
|
**API Client:** {{API_CLIENT}}
|
|
50
38
|
|
|
51
39
|
{{API_INTEGRATION_DESCRIPTION}}
|
|
52
|
-
|
|
53
|
-
---
|
|
54
|
-
|
|
40
|
+
---
|
|
55
41
|
## 💾 State Management
|
|
56
42
|
|
|
57
43
|
**State Solution:** {{STATE_MANAGEMENT}}
|
|
@@ -59,9 +45,7 @@
|
|
|
59
45
|
**Storage:** {{STORAGE_SOLUTION}}
|
|
60
46
|
|
|
61
47
|
{{STATE_MANAGEMENT_DESCRIPTION}}
|
|
62
|
-
|
|
63
|
-
---
|
|
64
|
-
|
|
48
|
+
---
|
|
65
49
|
## 🧭 Navigation
|
|
66
50
|
|
|
67
51
|
**Navigation Library:** {{NAVIGATION_LIBRARY}}
|
|
@@ -69,32 +53,24 @@
|
|
|
69
53
|
**Navigation Pattern:** {{NAVIGATION_PATTERN}}
|
|
70
54
|
|
|
71
55
|
{{NAVIGATION_ARCHITECTURE_DESCRIPTION}}
|
|
72
|
-
|
|
73
|
-
---
|
|
74
|
-
|
|
56
|
+
---
|
|
75
57
|
## 🔐 Security
|
|
76
58
|
|
|
77
59
|
{{SECURITY_DESCRIPTION}}
|
|
78
|
-
|
|
79
|
-
---
|
|
80
|
-
|
|
60
|
+
---
|
|
81
61
|
## 📱 Platform-Specific Code
|
|
82
62
|
|
|
83
63
|
{{PLATFORM_SPECIFIC_CODE_DESCRIPTION}}
|
|
84
|
-
|
|
85
|
-
---
|
|
86
|
-
|
|
64
|
+
---
|
|
87
65
|
## 🧪 Testing Strategy
|
|
88
66
|
|
|
89
67
|
{{TESTING_STRATEGY_DESCRIPTION}}
|
|
90
|
-
|
|
91
|
-
---
|
|
92
|
-
|
|
68
|
+
---
|
|
93
69
|
## 🚀 Performance Considerations
|
|
94
70
|
|
|
95
71
|
{{PERFORMANCE_CONSIDERATIONS}}
|
|
72
|
+
---
|
|
73
|
+
**Last Updated:** {{LAST_UPDATED}}
|
|
96
74
|
|
|
97
|
-
---
|
|
98
75
|
|
|
99
|
-
**Last Updated:** {{LAST_UPDATED}}
|
|
100
76
|
|
|
@@ -1,9 +1,7 @@
|
|
|
1
1
|
# Native Features Guide
|
|
2
2
|
|
|
3
3
|
> Native features integration for {{PROJECT_NAME}}
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
4
|
+
---
|
|
7
5
|
## 📱 Native Features Overview
|
|
8
6
|
|
|
9
7
|
**Framework:** {{FRAMEWORK}}
|
|
@@ -11,9 +9,7 @@
|
|
|
11
9
|
**Native Modules:** {{NATIVE_MODULES_LIST}}
|
|
12
10
|
|
|
13
11
|
**Third-Party SDKs:** {{THIRD_PARTY_SDKS_LIST}}
|
|
14
|
-
|
|
15
|
-
---
|
|
16
|
-
|
|
12
|
+
---
|
|
17
13
|
## 🔐 Permissions
|
|
18
14
|
|
|
19
15
|
**Required Permissions:**
|
|
@@ -21,108 +17,84 @@
|
|
|
21
17
|
|
|
22
18
|
**Permission Handling:**
|
|
23
19
|
{{PERMISSION_HANDLING_DESCRIPTION}}
|
|
24
|
-
|
|
25
|
-
---
|
|
26
|
-
|
|
20
|
+
---
|
|
27
21
|
## 📷 Camera
|
|
28
22
|
|
|
29
23
|
**Library:** {{CAMERA_LIBRARY}}
|
|
30
24
|
|
|
31
25
|
**Usage:**
|
|
32
26
|
{{CAMERA_USAGE_DESCRIPTION}}
|
|
33
|
-
|
|
34
|
-
---
|
|
35
|
-
|
|
27
|
+
---
|
|
36
28
|
## 📍 Location
|
|
37
29
|
|
|
38
30
|
**Library:** {{LOCATION_LIBRARY}}
|
|
39
31
|
|
|
40
32
|
**Usage:**
|
|
41
33
|
{{LOCATION_USAGE_DESCRIPTION}}
|
|
42
|
-
|
|
43
|
-
---
|
|
44
|
-
|
|
34
|
+
---
|
|
45
35
|
## 🔔 Push Notifications
|
|
46
36
|
|
|
47
37
|
**Service:** {{PUSH_NOTIFICATION_SERVICE}}
|
|
48
38
|
|
|
49
39
|
**Setup:**
|
|
50
40
|
{{PUSH_NOTIFICATION_SETUP}}
|
|
51
|
-
|
|
52
|
-
---
|
|
53
|
-
|
|
41
|
+
---
|
|
54
42
|
## 🔐 Biometric Authentication
|
|
55
43
|
|
|
56
44
|
**Library:** {{BIOMETRIC_LIBRARY}}
|
|
57
45
|
|
|
58
46
|
**Usage:**
|
|
59
47
|
{{BIOMETRIC_USAGE_DESCRIPTION}}
|
|
60
|
-
|
|
61
|
-
---
|
|
62
|
-
|
|
48
|
+
---
|
|
63
49
|
## 📁 File System
|
|
64
50
|
|
|
65
51
|
**Library:** {{FILE_SYSTEM_LIBRARY}}
|
|
66
52
|
|
|
67
53
|
**Usage:**
|
|
68
54
|
{{FILE_SYSTEM_USAGE_DESCRIPTION}}
|
|
69
|
-
|
|
70
|
-
---
|
|
71
|
-
|
|
55
|
+
---
|
|
72
56
|
## 📞 Contacts
|
|
73
57
|
|
|
74
58
|
**Library:** {{CONTACTS_LIBRARY}}
|
|
75
59
|
|
|
76
60
|
**Usage:**
|
|
77
61
|
{{CONTACTS_USAGE_DESCRIPTION}}
|
|
78
|
-
|
|
79
|
-
---
|
|
80
|
-
|
|
62
|
+
---
|
|
81
63
|
## 🗺️ Maps
|
|
82
64
|
|
|
83
65
|
**Library:** {{MAPS_LIBRARY}}
|
|
84
66
|
|
|
85
67
|
**Usage:**
|
|
86
68
|
{{MAPS_USAGE_DESCRIPTION}}
|
|
87
|
-
|
|
88
|
-
---
|
|
89
|
-
|
|
69
|
+
---
|
|
90
70
|
## 💳 Payments
|
|
91
71
|
|
|
92
72
|
**Library:** {{PAYMENTS_LIBRARY}}
|
|
93
73
|
|
|
94
74
|
**Usage:**
|
|
95
75
|
{{PAYMENTS_USAGE_DESCRIPTION}}
|
|
96
|
-
|
|
97
|
-
---
|
|
98
|
-
|
|
76
|
+
---
|
|
99
77
|
## 🔗 Deep Linking
|
|
100
78
|
|
|
101
79
|
**Strategy:** {{DEEP_LINKING_STRATEGY}}
|
|
102
80
|
|
|
103
81
|
**Implementation:**
|
|
104
82
|
{{DEEP_LINKING_IMPLEMENTATION}}
|
|
105
|
-
|
|
106
|
-
---
|
|
107
|
-
|
|
83
|
+
---
|
|
108
84
|
## 📊 Analytics
|
|
109
85
|
|
|
110
86
|
**Service:** {{ANALYTICS_SERVICE}}
|
|
111
87
|
|
|
112
88
|
**Setup:**
|
|
113
89
|
{{ANALYTICS_SETUP}}
|
|
114
|
-
|
|
115
|
-
---
|
|
116
|
-
|
|
90
|
+
---
|
|
117
91
|
## 🐛 Crash Reporting
|
|
118
92
|
|
|
119
93
|
**Service:** {{CRASH_REPORTING_SERVICE}}
|
|
120
94
|
|
|
121
95
|
**Setup:**
|
|
122
96
|
{{CRASH_REPORTING_SETUP}}
|
|
123
|
-
|
|
124
|
-
---
|
|
125
|
-
|
|
97
|
+
---
|
|
126
98
|
## ✅ Best Practices
|
|
127
99
|
|
|
128
100
|
1. **Request Permissions Just-In-Time** - Explain why needed
|
|
@@ -130,8 +102,8 @@
|
|
|
130
102
|
3. **Test Native Features** - Test on real devices
|
|
131
103
|
4. **Handle Platform Differences** - iOS vs Android
|
|
132
104
|
5. **Monitor Native Module Performance** - Watch for memory leaks
|
|
105
|
+
---
|
|
106
|
+
**Last Updated:** {{LAST_UPDATED}}
|
|
133
107
|
|
|
134
|
-
---
|
|
135
108
|
|
|
136
|
-
**Last Updated:** {{LAST_UPDATED}}
|
|
137
109
|
|
|
@@ -1,9 +1,7 @@
|
|
|
1
1
|
# Navigation Guide
|
|
2
2
|
|
|
3
3
|
> Navigation patterns and setup for {{PROJECT_NAME}}
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
4
|
+
---
|
|
7
5
|
## 🧭 Navigation Overview
|
|
8
6
|
|
|
9
7
|
**Navigation Library:** {{NAVIGATION_LIBRARY}}
|
|
@@ -11,9 +9,7 @@
|
|
|
11
9
|
**Navigation Pattern:** {{NAVIGATION_PATTERN}}
|
|
12
10
|
|
|
13
11
|
**Deep Linking Strategy:** {{DEEP_LINKING_STRATEGY}}
|
|
14
|
-
|
|
15
|
-
---
|
|
16
|
-
|
|
12
|
+
---
|
|
17
13
|
## 📱 Navigation Structure
|
|
18
14
|
|
|
19
15
|
{{NAVIGATION_STRUCTURE_DESCRIPTION}}
|
|
@@ -23,9 +19,7 @@
|
|
|
23
19
|
```
|
|
24
20
|
{{NAVIGATION_HIERARCHY}}
|
|
25
21
|
```
|
|
26
|
-
|
|
27
|
-
---
|
|
28
|
-
|
|
22
|
+
---
|
|
29
23
|
## 🔗 Deep Linking
|
|
30
24
|
|
|
31
25
|
**URL Scheme:** {{URL_SCHEME}}
|
|
@@ -41,26 +35,20 @@
|
|
|
41
35
|
### Implementation
|
|
42
36
|
|
|
43
37
|
{{DEEP_LINKING_IMPLEMENTATION}}
|
|
44
|
-
|
|
45
|
-
---
|
|
46
|
-
|
|
38
|
+
---
|
|
47
39
|
## 🎨 Screen Transitions
|
|
48
40
|
|
|
49
41
|
**Transition Style:** {{TRANSITION_STYLE}}
|
|
50
42
|
|
|
51
43
|
{{TRANSITION_DESCRIPTION}}
|
|
52
|
-
|
|
53
|
-
---
|
|
54
|
-
|
|
44
|
+
---
|
|
55
45
|
## 🔐 Protected Routes
|
|
56
46
|
|
|
57
47
|
**Authentication Flow:** {{AUTH_FLOW_DESCRIPTION}}
|
|
58
48
|
|
|
59
49
|
**Protected Screens:**
|
|
60
50
|
{{PROTECTED_SCREENS_LIST}}
|
|
61
|
-
|
|
62
|
-
---
|
|
63
|
-
|
|
51
|
+
---
|
|
64
52
|
## 📚 Navigation Best Practices
|
|
65
53
|
|
|
66
54
|
1. **Consistent Navigation** - Use consistent navigation patterns throughout the app
|
|
@@ -68,14 +56,12 @@
|
|
|
68
56
|
3. **Back Button Handling** - Handle back button appropriately on Android
|
|
69
57
|
4. **Deep Links** - Support deep linking for key screens
|
|
70
58
|
5. **State Preservation** - Preserve navigation state when app backgrounds
|
|
71
|
-
|
|
72
|
-
---
|
|
73
|
-
|
|
59
|
+
---
|
|
74
60
|
## 🛠️ Implementation Examples
|
|
75
61
|
|
|
76
62
|
{{NAVIGATION_EXAMPLES}}
|
|
63
|
+
---
|
|
64
|
+
**Last Updated:** {{LAST_UPDATED}}
|
|
77
65
|
|
|
78
|
-
---
|
|
79
66
|
|
|
80
|
-
**Last Updated:** {{LAST_UPDATED}}
|
|
81
67
|
|
|
@@ -1,9 +1,7 @@
|
|
|
1
1
|
# Offline Strategy
|
|
2
2
|
|
|
3
3
|
> Offline and data synchronization strategy for {{PROJECT_NAME}}
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
4
|
+
---
|
|
7
5
|
## 📡 Offline Overview
|
|
8
6
|
|
|
9
7
|
**Offline Strategy:** {{OFFLINE_STRATEGY}}
|
|
@@ -13,18 +11,14 @@
|
|
|
13
11
|
**Sync Strategy:** {{SYNC_STRATEGY}}
|
|
14
12
|
|
|
15
13
|
**Conflict Resolution:** {{CONFLICT_RESOLUTION}}
|
|
16
|
-
|
|
17
|
-
---
|
|
18
|
-
|
|
14
|
+
---
|
|
19
15
|
## 💾 Local Storage
|
|
20
16
|
|
|
21
17
|
**Storage Solution:** {{STORAGE_SOLUTION}}
|
|
22
18
|
|
|
23
19
|
**Storage Structure:**
|
|
24
20
|
{{STORAGE_STRUCTURE_DESCRIPTION}}
|
|
25
|
-
|
|
26
|
-
---
|
|
27
|
-
|
|
21
|
+
---
|
|
28
22
|
## 🔄 Data Synchronization
|
|
29
23
|
|
|
30
24
|
**Sync Strategy:** {{SYNC_STRATEGY}}
|
|
@@ -39,17 +33,13 @@
|
|
|
39
33
|
### Background Sync
|
|
40
34
|
|
|
41
35
|
{{BACKGROUND_SYNC_DESCRIPTION}}
|
|
42
|
-
|
|
43
|
-
---
|
|
44
|
-
|
|
36
|
+
---
|
|
45
37
|
## ⚔️ Conflict Resolution
|
|
46
38
|
|
|
47
39
|
**Strategy:** {{CONFLICT_RESOLUTION_STRATEGY}}
|
|
48
40
|
|
|
49
41
|
{{CONFLICT_RESOLUTION_DESCRIPTION}}
|
|
50
|
-
|
|
51
|
-
---
|
|
52
|
-
|
|
42
|
+
---
|
|
53
43
|
## 📊 Caching Strategy
|
|
54
44
|
|
|
55
45
|
**Cache Strategy:** {{CACHE_STRATEGY}}
|
|
@@ -57,9 +47,7 @@
|
|
|
57
47
|
**Cache Duration:** {{CACHE_DURATION}}
|
|
58
48
|
|
|
59
49
|
**Cache Invalidation:** {{CACHE_INVALIDATION}}
|
|
60
|
-
|
|
61
|
-
---
|
|
62
|
-
|
|
50
|
+
---
|
|
63
51
|
## 🔌 Network Handling
|
|
64
52
|
|
|
65
53
|
**Network Detection:** {{NETWORK_DETECTION}}
|
|
@@ -67,15 +55,11 @@
|
|
|
67
55
|
**Offline Indicators:** {{OFFLINE_INDICATORS}}
|
|
68
56
|
|
|
69
57
|
**Retry Strategy:** {{RETRY_STRATEGY}}
|
|
70
|
-
|
|
71
|
-
---
|
|
72
|
-
|
|
58
|
+
---
|
|
73
59
|
## 🛠️ Implementation
|
|
74
60
|
|
|
75
61
|
{{OFFLINE_IMPLEMENTATION}}
|
|
76
|
-
|
|
77
|
-
---
|
|
78
|
-
|
|
62
|
+
---
|
|
79
63
|
## ✅ Best Practices
|
|
80
64
|
|
|
81
65
|
1. **Cache Critical Data** - Cache data needed for offline functionality
|
|
@@ -83,8 +67,8 @@
|
|
|
83
67
|
3. **Queue Updates** - Queue writes for when connection is restored
|
|
84
68
|
4. **Handle Conflicts** - Implement conflict resolution strategy
|
|
85
69
|
5. **Test Offline Scenarios** - Test all offline flows
|
|
70
|
+
---
|
|
71
|
+
**Last Updated:** {{LAST_UPDATED}}
|
|
86
72
|
|
|
87
|
-
---
|
|
88
73
|
|
|
89
|
-
**Last Updated:** {{LAST_UPDATED}}
|
|
90
74
|
|
|
@@ -1,23 +1,17 @@
|
|
|
1
1
|
# Permissions Guide
|
|
2
2
|
|
|
3
3
|
> Permission handling for {{PROJECT_NAME}}
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
4
|
+
---
|
|
7
5
|
## 🔐 Permissions Overview
|
|
8
6
|
|
|
9
7
|
**Permission Request Strategy:** {{PERMISSION_REQUEST_STRATEGY}}
|
|
10
8
|
|
|
11
9
|
**Permission Denial Handling:** {{PERMISSION_DENIAL_HANDLING}}
|
|
12
|
-
|
|
13
|
-
---
|
|
14
|
-
|
|
10
|
+
---
|
|
15
11
|
## 📋 Required Permissions
|
|
16
12
|
|
|
17
13
|
{{PERMISSIONS_LIST_WITH_DESCRIPTIONS}}
|
|
18
|
-
|
|
19
|
-
---
|
|
20
|
-
|
|
14
|
+
---
|
|
21
15
|
## 🎯 Permission Request Flow
|
|
22
16
|
|
|
23
17
|
### Just-In-Time Requests
|
|
@@ -27,17 +21,13 @@
|
|
|
27
21
|
### Permission Request Examples
|
|
28
22
|
|
|
29
23
|
{{PERMISSION_REQUEST_EXAMPLES}}
|
|
30
|
-
|
|
31
|
-
---
|
|
32
|
-
|
|
24
|
+
---
|
|
33
25
|
## ❌ Handling Denied Permissions
|
|
34
26
|
|
|
35
27
|
**Strategy:** {{PERMISSION_DENIAL_STRATEGY}}
|
|
36
28
|
|
|
37
29
|
{{PERMISSION_DENIAL_HANDLING_DESCRIPTION}}
|
|
38
|
-
|
|
39
|
-
---
|
|
40
|
-
|
|
30
|
+
---
|
|
41
31
|
## 📱 Platform-Specific Considerations
|
|
42
32
|
|
|
43
33
|
### iOS
|
|
@@ -47,15 +37,11 @@
|
|
|
47
37
|
### Android
|
|
48
38
|
|
|
49
39
|
{{ANDROID_PERMISSIONS_DESCRIPTION}}
|
|
50
|
-
|
|
51
|
-
---
|
|
52
|
-
|
|
40
|
+
---
|
|
53
41
|
## 🛠️ Implementation
|
|
54
42
|
|
|
55
43
|
{{PERMISSIONS_IMPLEMENTATION}}
|
|
56
|
-
|
|
57
|
-
---
|
|
58
|
-
|
|
44
|
+
---
|
|
59
45
|
## ✅ Best Practices
|
|
60
46
|
|
|
61
47
|
1. **Request Just-In-Time** - Request permissions when feature is needed
|
|
@@ -63,8 +49,8 @@
|
|
|
63
49
|
3. **Handle Denial** - Gracefully handle permission denial
|
|
64
50
|
4. **Provide Alternatives** - Offer alternatives when permission is denied
|
|
65
51
|
5. **Test Permission Flows** - Test all permission scenarios
|
|
52
|
+
---
|
|
53
|
+
**Last Updated:** {{LAST_UPDATED}}
|
|
66
54
|
|
|
67
|
-
---
|
|
68
55
|
|
|
69
|
-
**Last Updated:** {{LAST_UPDATED}}
|
|
70
56
|
|
|
@@ -1,9 +1,7 @@
|
|
|
1
1
|
# State Management Guide
|
|
2
2
|
|
|
3
3
|
> State management patterns for {{PROJECT_NAME}}
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
4
|
+
---
|
|
7
5
|
## 🎯 State Management Solution
|
|
8
6
|
|
|
9
7
|
**Solution:** {{STATE_MANAGEMENT}}
|
|
@@ -11,9 +9,7 @@
|
|
|
11
9
|
**Storage:** {{STORAGE_SOLUTION}}
|
|
12
10
|
|
|
13
11
|
**Offline Strategy:** {{OFFLINE_STRATEGY}}
|
|
14
|
-
|
|
15
|
-
---
|
|
16
|
-
|
|
12
|
+
---
|
|
17
13
|
## 📊 State Categories
|
|
18
14
|
|
|
19
15
|
### 1. App State (Global)
|
|
@@ -27,9 +23,7 @@
|
|
|
27
23
|
|
|
28
24
|
**Pattern:**
|
|
29
25
|
{{APP_STATE_EXAMPLE}}
|
|
30
|
-
|
|
31
|
-
---
|
|
32
|
-
|
|
26
|
+
---
|
|
33
27
|
### 2. Server State (Remote Data)
|
|
34
28
|
|
|
35
29
|
**Managed by:** {{DATA_FETCHING}}
|
|
@@ -41,9 +35,7 @@
|
|
|
41
35
|
|
|
42
36
|
**Pattern:**
|
|
43
37
|
{{SERVER_STATE_EXAMPLE}}
|
|
44
|
-
|
|
45
|
-
---
|
|
46
|
-
|
|
38
|
+
---
|
|
47
39
|
### 3. Local State (Component State)
|
|
48
40
|
|
|
49
41
|
**Managed by:** Component state / Hooks
|
|
@@ -55,9 +47,7 @@
|
|
|
55
47
|
|
|
56
48
|
**Pattern:**
|
|
57
49
|
{{LOCAL_STATE_EXAMPLE}}
|
|
58
|
-
|
|
59
|
-
---
|
|
60
|
-
|
|
50
|
+
---
|
|
61
51
|
### 4. Persistent State (Local Storage)
|
|
62
52
|
|
|
63
53
|
**Managed by:** {{STORAGE_SOLUTION}}
|
|
@@ -69,39 +59,29 @@
|
|
|
69
59
|
|
|
70
60
|
**Pattern:**
|
|
71
61
|
{{PERSISTENT_STATE_EXAMPLE}}
|
|
72
|
-
|
|
73
|
-
---
|
|
74
|
-
|
|
62
|
+
---
|
|
75
63
|
## 🔄 Data Synchronization
|
|
76
64
|
|
|
77
65
|
**Sync Strategy:** {{SYNC_STRATEGY}}
|
|
78
66
|
|
|
79
67
|
{{SYNC_DESCRIPTION}}
|
|
80
|
-
|
|
81
|
-
---
|
|
82
|
-
|
|
68
|
+
---
|
|
83
69
|
## 💾 Offline Handling
|
|
84
70
|
|
|
85
71
|
**Offline Strategy:** {{OFFLINE_STRATEGY}}
|
|
86
72
|
|
|
87
73
|
{{OFFLINE_HANDLING_DESCRIPTION}}
|
|
88
|
-
|
|
89
|
-
---
|
|
90
|
-
|
|
74
|
+
---
|
|
91
75
|
## ⚔️ Conflict Resolution
|
|
92
76
|
|
|
93
77
|
**Strategy:** {{CONFLICT_RESOLUTION}}
|
|
94
78
|
|
|
95
79
|
{{CONFLICT_RESOLUTION_DESCRIPTION}}
|
|
96
|
-
|
|
97
|
-
---
|
|
98
|
-
|
|
80
|
+
---
|
|
99
81
|
## 🛠️ Implementation Examples
|
|
100
82
|
|
|
101
83
|
{{STATE_MANAGEMENT_EXAMPLES}}
|
|
102
|
-
|
|
103
|
-
---
|
|
104
|
-
|
|
84
|
+
---
|
|
105
85
|
## ✅ Best Practices
|
|
106
86
|
|
|
107
87
|
1. **Separate Concerns** - Keep app state, server state, and local state separate
|
|
@@ -109,8 +89,8 @@
|
|
|
109
89
|
3. **Handle Offline** - Always handle offline scenarios
|
|
110
90
|
4. **Optimize Performance** - Use memoization and selectors
|
|
111
91
|
5. **Test State Logic** - Write tests for state management logic
|
|
92
|
+
---
|
|
93
|
+
**Last Updated:** {{LAST_UPDATED}}
|
|
112
94
|
|
|
113
|
-
---
|
|
114
95
|
|
|
115
|
-
**Last Updated:** {{LAST_UPDATED}}
|
|
116
96
|
|