@cbnventures/nova 0.34.1 → 0.36.0

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.
Files changed (158) hide show
  1. package/bin/nova.mjs +17 -0
  2. package/build/package.json +3 -2
  3. package/build/scaffold-versions.json +16 -6
  4. package/build/src/cli/generate/github/workflows-blueprint-validate.d.ts +2 -2
  5. package/build/src/cli/generate/github/workflows-blueprint-validate.d.ts.map +1 -1
  6. package/build/src/cli/generate/github/workflows-blueprint-validate.js +116 -3
  7. package/build/src/cli/generate/github/workflows-blueprint-validate.js.map +1 -1
  8. package/build/src/cli/generate/github/workflows-blueprint.d.ts +11 -5
  9. package/build/src/cli/generate/github/workflows-blueprint.d.ts.map +1 -1
  10. package/build/src/cli/generate/github/workflows-blueprint.js +411 -35
  11. package/build/src/cli/generate/github/workflows-blueprint.js.map +1 -1
  12. package/build/src/cli/generate/must-haves/agent-conventions.d.ts.map +1 -1
  13. package/build/src/cli/generate/must-haves/agent-conventions.js +3 -0
  14. package/build/src/cli/generate/must-haves/agent-conventions.js.map +1 -1
  15. package/build/src/cli/generate/must-haves/dotenv.d.ts.map +1 -1
  16. package/build/src/cli/generate/must-haves/dotenv.js +1 -0
  17. package/build/src/cli/generate/must-haves/dotenv.js.map +1 -1
  18. package/build/src/cli/scaffold/app/vite.js +1 -1
  19. package/build/src/cli/scaffold/app/vite.js.map +1 -1
  20. package/build/src/cli/utility/changelog.d.ts.map +1 -1
  21. package/build/src/cli/utility/changelog.js +119 -67
  22. package/build/src/cli/utility/changelog.js.map +1 -1
  23. package/build/src/cli/utility/configure.d.ts.map +1 -1
  24. package/build/src/cli/utility/configure.js +126 -1
  25. package/build/src/cli/utility/configure.js.map +1 -1
  26. package/build/src/lib/corepack.d.ts +2 -2
  27. package/build/src/lib/corepack.d.ts.map +1 -1
  28. package/build/src/lib/corepack.js +16 -6
  29. package/build/src/lib/corepack.js.map +1 -1
  30. package/build/src/lib/docker-packaging.d.ts.map +1 -1
  31. package/build/src/lib/docker-packaging.js +5 -4
  32. package/build/src/lib/docker-packaging.js.map +1 -1
  33. package/build/src/lib/dotenv.d.ts.map +1 -1
  34. package/build/src/lib/dotenv.js +17 -8
  35. package/build/src/lib/dotenv.js.map +1 -1
  36. package/build/src/lib/env-managed-set.d.ts.map +1 -1
  37. package/build/src/lib/env-managed-set.js +55 -11
  38. package/build/src/lib/env-managed-set.js.map +1 -1
  39. package/build/src/lib/env-namespace.d.ts.map +1 -1
  40. package/build/src/lib/env-namespace.js +1 -0
  41. package/build/src/lib/env-namespace.js.map +1 -1
  42. package/build/src/lib/env-profiles.d.ts +3 -0
  43. package/build/src/lib/env-profiles.d.ts.map +1 -0
  44. package/build/src/lib/env-profiles.js +70 -0
  45. package/build/src/lib/env-profiles.js.map +1 -0
  46. package/build/src/lib/env-status.d.ts.map +1 -1
  47. package/build/src/lib/env-status.js +23 -2
  48. package/build/src/lib/env-status.js.map +1 -1
  49. package/build/src/lib/item.d.ts.map +1 -1
  50. package/build/src/lib/item.js +20 -3
  51. package/build/src/lib/item.js.map +1 -1
  52. package/build/src/lib/nova-config.d.ts.map +1 -1
  53. package/build/src/lib/nova-config.js +31 -0
  54. package/build/src/lib/nova-config.js.map +1 -1
  55. package/build/src/lib/regex.d.ts +7 -0
  56. package/build/src/lib/regex.d.ts.map +1 -1
  57. package/build/src/lib/regex.js +7 -0
  58. package/build/src/lib/regex.js.map +1 -1
  59. package/build/src/lib/run-scripts.d.ts.map +1 -1
  60. package/build/src/lib/run-scripts.js +24 -0
  61. package/build/src/lib/run-scripts.js.map +1 -1
  62. package/build/src/lib/scaffold.d.ts.map +1 -1
  63. package/build/src/lib/scaffold.js +7 -0
  64. package/build/src/lib/scaffold.js.map +1 -1
  65. package/build/src/lib/workflow-templates.js +4 -4
  66. package/build/src/lib/workflow-templates.js.map +1 -1
  67. package/build/src/types/cli/generate/github/workflows-blueprint-validate.d.ts +42 -4
  68. package/build/src/types/cli/generate/github/workflows-blueprint.d.ts +193 -17
  69. package/build/src/types/cli/utility/changelog.d.ts +49 -6
  70. package/build/src/types/cli/utility/configure.d.ts +52 -0
  71. package/build/src/types/lib/corepack.d.ts +13 -0
  72. package/build/src/types/lib/docker-packaging.d.ts +1 -0
  73. package/build/src/types/lib/dotenv.d.ts +10 -3
  74. package/build/src/types/lib/env-managed-set.d.ts +15 -0
  75. package/build/src/types/lib/env-namespace.d.ts +5 -0
  76. package/build/src/types/lib/env-profiles.d.ts +67 -0
  77. package/build/src/types/lib/env-status.d.ts +9 -0
  78. package/build/src/types/lib/item.d.ts +20 -3
  79. package/build/src/types/lib/nova-config.d.ts +14 -0
  80. package/build/src/types/lib/run-scripts.d.ts +16 -0
  81. package/build/src/types/lib/scaffold.d.ts +8 -0
  82. package/build/src/types/shared.d.ts +47 -0
  83. package/build/src/types/tests/cli/generate/github/workflows-blueprint-publish-parity.test.d.ts +20 -0
  84. package/build/src/types/tests/cli/generate/github/workflows-blueprint-validate.test.d.ts +22 -0
  85. package/build/src/types/tests/cli/generate/github/workflows-blueprint.test.d.ts +16 -0
  86. package/build/src/types/tests/cli/generate/must-haves/agent-conventions.test.d.ts +40 -0
  87. package/build/src/types/tests/cli/scaffold/app/android.test.d.ts +2 -0
  88. package/build/src/types/tests/cli/utility/changelog.test.d.ts +48 -45
  89. package/build/src/types/tests/cli/utility/configure.test.d.ts +1 -0
  90. package/build/src/types/tests/cli/utility/run-scripts.test.d.ts +29 -0
  91. package/build/src/types/tests/lib/env-profiles.test.d.ts +20 -0
  92. package/build/src/types/tests/scaffold-output-contract.test.d.ts +27 -0
  93. package/build/templates/generators/must-haves/agent-conventions/AGENTS.md +8 -5
  94. package/build/templates/generators/must-haves/agent-conventions/CLAUDE.md +8 -5
  95. package/build/templates/generators/must-haves/agent-conventions/conventions/csharp.md +6 -6
  96. package/build/templates/generators/must-haves/agent-conventions/conventions/go.md +241 -0
  97. package/build/templates/generators/must-haves/agent-conventions/conventions/nova.md +155 -0
  98. package/build/templates/generators/must-haves/agent-conventions/conventions/python.md +7 -7
  99. package/build/templates/generators/must-haves/agent-conventions/conventions/rust.md +227 -0
  100. package/build/templates/generators/must-haves/agent-conventions/conventions/swift.md +9 -9
  101. package/build/templates/generators/must-haves/agent-conventions/conventions/typescript.md +145 -23
  102. package/build/templates/generators/must-haves/agent-conventions/conventions/universal.md +112 -103
  103. package/build/templates/generators/must-haves/ignore-files/gitignore +1 -0
  104. package/build/templates/scaffold/app/android/package.json +1 -1
  105. package/build/templates/scaffold/app/apple/Sources/App.swift +15 -2
  106. package/build/templates/scaffold/app/apple/Sources/ContentView.swift +6 -6
  107. package/build/templates/scaffold/app/apple/Sources/Localizable.xcstrings +75 -0
  108. package/build/templates/scaffold/app/apple/Tests/AppTests.swift +14 -2
  109. package/build/templates/scaffold/app/apple/package.json +1 -1
  110. package/build/templates/scaffold/app/astro/package.json +1 -1
  111. package/build/templates/scaffold/app/astro/src/i18n/en.json +48 -0
  112. package/build/templates/scaffold/app/astro/src/pages/index.astro +31 -30
  113. package/build/templates/scaffold/app/discord-bot/package.json +1 -1
  114. package/build/templates/scaffold/app/express/package.json +1 -1
  115. package/build/templates/scaffold/app/nextjs/package.json +1 -1
  116. package/build/templates/scaffold/app/nextjs/src/app/[lang]/dictionaries/en.json +31 -0
  117. package/build/templates/scaffold/app/nextjs/src/app/[lang]/dictionaries.ts +33 -0
  118. package/build/templates/scaffold/app/nextjs/src/app/[lang]/layout.tsx +92 -0
  119. package/build/templates/scaffold/app/nextjs/src/app/{page.tsx → [lang]/page.tsx} +54 -34
  120. package/build/templates/scaffold/app/nextjs/src/i18n/config.ts +42 -0
  121. package/build/templates/scaffold/app/nextjs/src/proxy.ts +56 -0
  122. package/build/templates/scaffold/app/nextjs/src/types/app/[lang]/dictionaries.d.ts +21 -0
  123. package/build/templates/scaffold/app/nextjs/src/types/app/[lang]/layout.d.ts +63 -0
  124. package/build/templates/scaffold/app/nextjs/src/types/app/[lang]/page.d.ts +22 -0
  125. package/build/templates/scaffold/app/nextjs/src/types/i18n/config.d.ts +22 -0
  126. package/build/templates/scaffold/app/nextjs/src/types/proxy.d.ts +30 -0
  127. package/build/templates/scaffold/app/vite/package.json +2 -2
  128. package/build/templates/scaffold/app/vite/vite.config.mts +3 -0
  129. package/build/templates/scaffold/docs/docusaurus/package.json +2 -2
  130. package/build/templates/scaffold/docs/docusaurus/src/pages/index.tsx +81 -20
  131. package/build/templates/scaffold/docs/docusaurus/vitest.config.mts +9 -0
  132. package/build/templates/scaffold/package/github-action/package.json +1 -1
  133. package/build/templates/scaffold/package/homebridge/package.json +1 -1
  134. package/build/templates/scaffold/package/pfsense/package.json +1 -1
  135. package/build/templates/scaffold/package/pfsense/port/files/usr/local/pkg/[__WORKSPACE_NAME__].inc +10 -0
  136. package/build/templates/scaffold/package/pfsense-root/.github/workflows/pfsense-[__WORKSPACE_NAME__].yml +62 -0
  137. package/build/templates/scaffold-options/app/android-launchpad/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/ui/main/MainScreen.kt +40 -34
  138. package/build/templates/scaffold-options/app/android-native/.gitattributes +2 -0
  139. package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/MainActivity.kt +16 -2
  140. package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/NavigationKeys.kt +7 -1
  141. package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/data/DataRepository.kt +28 -4
  142. package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/theme/Color.kt +40 -6
  143. package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/theme/Theme.kt +22 -1
  144. package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/theme/Type.kt +8 -2
  145. package/build/templates/scaffold-options/app/android-native/app/src/main/java/[__ANDROID_PACKAGE_PATH__]/ui/main/MainScreenViewModel.kt +42 -6
  146. package/build/templates/scaffold-options/app/android-native/app/src/main/res/values/strings.xml +27 -0
  147. package/build/templates/scaffold-options/app/android-native/app/src/test/java/[__ANDROID_PACKAGE_PATH__]/ui/main/MainScreenViewModelTest.kt +31 -4
  148. package/build/templates/scaffold-options/app/astro/cloudflare/astro.config.mjs +7 -0
  149. package/build/templates/scaffold-options/app/astro/cloudflare/public/.assetsignore +15 -0
  150. package/build/templates/scaffold-options/app/astro/node/astro.config.mjs +7 -0
  151. package/build/templates/scaffold-options/app/astro/static/astro.config.mjs +7 -0
  152. package/build/templates/scaffold-options/docker-image/common/dockerignore +2 -0
  153. package/build/templates/scaffold-options/tool/serverless/cloudflare-workers/package.json +1 -1
  154. package/build/templates/scaffold-options/tool/serverless/vercel-functions/package.json +1 -1
  155. package/package.json +3 -2
  156. package/build/templates/scaffold/app/nextjs/src/app/layout.tsx +0 -46
  157. package/build/templates/scaffold/app/nextjs/src/types/app/layout.d.ts +0 -25
  158. package/build/templates/scaffold/app/nextjs/src/types/app/page.d.ts +0 -8
@@ -10,6 +10,8 @@ require_once('services.inc');
10
10
  * Returns the saved package settings.
11
11
  *
12
12
  * @return array<string, mixed> Package settings.
13
+ *
14
+ * @since UNRELEASED
13
15
  */
14
16
  function pfsensePackage[__WORKSPACE_IDENTIFIER__]GetSettings(): array
15
17
  {
@@ -24,6 +26,8 @@ function pfsensePackage[__WORKSPACE_IDENTIFIER__]GetSettings(): array
24
26
  * @param string $frequency Selected frequency.
25
27
  *
26
28
  * @return array{string, string, string, string, string} Cron fields.
29
+ *
30
+ * @since UNRELEASED
27
31
  */
28
32
  function pfsensePackage[__WORKSPACE_IDENTIFIER__]GetCronFields(string $frequency): array
29
33
  {
@@ -37,6 +41,8 @@ function pfsensePackage[__WORKSPACE_IDENTIFIER__]GetCronFields(string $frequency
37
41
 
38
42
  /**
39
43
  * Synchronizes the package cron job with the saved WebGUI settings.
44
+ *
45
+ * @since UNRELEASED
40
46
  */
41
47
  function pfsensePackage[__WORKSPACE_IDENTIFIER__]Sync(): void
42
48
  {
@@ -63,6 +69,8 @@ function pfsensePackage[__WORKSPACE_IDENTIFIER__]Sync(): void
63
69
 
64
70
  /**
65
71
  * Removes the package cron job.
72
+ *
73
+ * @since UNRELEASED
66
74
  */
67
75
  function pfsensePackage[__WORKSPACE_IDENTIFIER__]Remove(): void
68
76
  {
@@ -74,6 +82,8 @@ function pfsensePackage[__WORKSPACE_IDENTIFIER__]Remove(): void
74
82
  *
75
83
  * @param array<string, mixed> $post Submitted values.
76
84
  * @param string[] $inputErrors Validation errors.
85
+ *
86
+ * @since UNRELEASED
77
87
  */
78
88
  function pfsensePackage[__WORKSPACE_IDENTIFIER__]Validate(array $post, array &$inputErrors): void
79
89
  {
@@ -0,0 +1,62 @@
1
+ name: "Publish [__WORKSPACE_TITLE__] pfSense Package"
2
+
3
+ on:
4
+ release:
5
+ types:
6
+ - "published"
7
+ workflow_dispatch:
8
+ inputs:
9
+ tag:
10
+ description: "Existing GitHub release tag that receives the package"
11
+ required: true
12
+ type: "string"
13
+
14
+ permissions:
15
+ contents: "write"
16
+
17
+ concurrency:
18
+ group: "${{ github.workflow }}-${{ github.event.release.tag_name || inputs.tag }}"
19
+ cancel-in-progress: false
20
+
21
+ jobs:
22
+ package:
23
+ name: "Build pfSense Package"
24
+ runs-on: "ubuntu-latest"
25
+ env:
26
+ RELEASE_TAG: "${{ github.event.release.tag_name || inputs.tag }}"
27
+
28
+ steps:
29
+ - name: "Checkout"
30
+ uses: "actions/checkout@v7"
31
+
32
+ - name: "Validate and Stage Port"
33
+ run: |
34
+ node "./[__WORKSPACE_RELATIVE_PATH__]/scripts/check-package.mjs"
35
+ node "./[__WORKSPACE_RELATIVE_PATH__]/scripts/stage-package.mjs"
36
+
37
+ - name: "Build on FreeBSD"
38
+ uses: "vmactions/freebsd-vm@v1"
39
+ with:
40
+ release: "${{ vars.PFSENSE_FREEBSD_VERSION || '15' }}"
41
+ copyback: true
42
+ prepare: |
43
+ pkg install -y ca_root_nss git
44
+ run: |
45
+ git clone --depth 1 --single-branch --branch devel --filter=blob:none --sparse https://github.com/pfsense/FreeBSD-ports.git /usr/ports
46
+ git -C /usr/ports sparse-checkout set Mk Templates Keywords
47
+ PFSENSE_PORTS_DIR=/usr/ports sh "./[__WORKSPACE_RELATIVE_PATH__]/scripts/build-package.sh"
48
+
49
+ - name: "Upload Workflow Artifact"
50
+ uses: "actions/upload-artifact@v7"
51
+ with:
52
+ name: "pfsense-[__WORKSPACE_NAME__]"
53
+ path: "./[__WORKSPACE_RELATIVE_PATH__]/build/release/*"
54
+ if-no-files-found: "error"
55
+ retention-days: 7
56
+ include-hidden-files: true
57
+
58
+ - name: "Upload GitHub Release Assets"
59
+ env:
60
+ GH_TOKEN: "${{ github.token }}"
61
+ run: |
62
+ gh release upload "${RELEASE_TAG}" "./[__WORKSPACE_RELATIVE_PATH__]/build/release/"* --clobber
@@ -1,5 +1,6 @@
1
1
  package [__ANDROID_APPLICATION_ID__].ui.main
2
2
 
3
+ import androidx.annotation.StringRes
3
4
  import androidx.compose.foundation.background
4
5
  import androidx.compose.foundation.border
5
6
  import androidx.compose.foundation.clickable
@@ -33,6 +34,7 @@ import androidx.compose.ui.Modifier
33
34
  import androidx.compose.ui.draw.clip
34
35
  import androidx.compose.ui.platform.LocalUriHandler
35
36
  import androidx.compose.ui.res.painterResource
37
+ import androidx.compose.ui.res.stringResource
36
38
  import androidx.compose.ui.semantics.heading
37
39
  import androidx.compose.ui.semantics.Role
38
40
  import androidx.compose.ui.semantics.semantics
@@ -116,7 +118,7 @@ public fun MainScreen(
116
118
  */
117
119
  @Composable
118
120
  internal fun MainScreen(data: List<String>, modifier: Modifier = Modifier) {
119
- val platformName = data.firstOrNull() ?: "Android"
121
+ val platformName = data.firstOrNull() ?: stringResource(R.string.platform_android)
120
122
  val uriHandler = LocalUriHandler.current
121
123
 
122
124
  Column(
@@ -196,11 +198,11 @@ private fun MainScreenHeader(
196
198
  Image(
197
199
  modifier = Modifier.size(36.dp),
198
200
  painter = painterResource(R.drawable.nova_logo),
199
- contentDescription = "Nova",
201
+ contentDescription = stringResource(R.string.nova_logo_content_description),
200
202
  )
201
203
 
202
204
  Text(
203
- text = "Nova × $platformName",
205
+ text = stringResource(R.string.nova_platform_name, platformName),
204
206
  fontWeight = FontWeight.Bold,
205
207
  style = MaterialTheme.typography.labelLarge,
206
208
  )
@@ -211,7 +213,7 @@ private fun MainScreenHeader(
211
213
  horizontalArrangement = Arrangement.spacedBy(6.dp),
212
214
  verticalAlignment = Alignment.CenterVertically,
213
215
  ) {
214
- Text("Read Nova Docs")
216
+ Text(stringResource(R.string.read_nova_docs))
215
217
 
216
218
  Icon(
217
219
  modifier = Modifier.size(16.dp),
@@ -242,7 +244,7 @@ private fun MainScreenIntroduction(
242
244
  Column(modifier = modifier) {
243
245
  Text(
244
246
  modifier = Modifier.semantics { heading() },
245
- text = "[__WORKSPACE_TITLE__] starts here.",
247
+ text = stringResource(R.string.starter_title),
246
248
  fontSize = 48.sp,
247
249
  fontWeight = FontWeight.Bold,
248
250
  letterSpacing = (-1.8).sp,
@@ -252,7 +254,7 @@ private fun MainScreenIntroduction(
252
254
  Spacer(modifier = Modifier.height(18.dp))
253
255
 
254
256
  Text(
255
- text = "A native Android workspace with strict checks, tests, and a clean path from first screen to release.",
257
+ text = stringResource(R.string.starter_description),
256
258
  color = MaterialTheme.colorScheme.onSurfaceVariant,
257
259
  lineHeight = 24.sp,
258
260
  style = MaterialTheme.typography.bodyLarge,
@@ -265,7 +267,7 @@ private fun MainScreenIntroduction(
265
267
  horizontalArrangement = Arrangement.spacedBy(6.dp),
266
268
  verticalAlignment = Alignment.CenterVertically,
267
269
  ) {
268
- Text("Explore Android docs")
270
+ Text(stringResource(R.string.explore_android_docs))
269
271
 
270
272
  Icon(
271
273
  modifier = Modifier.size(16.dp),
@@ -278,7 +280,7 @@ private fun MainScreenIntroduction(
278
280
  Spacer(modifier = Modifier.height(14.dp))
279
281
 
280
282
  Text(
281
- text = "Start in ui/main/MainScreen.kt",
283
+ text = stringResource(R.string.starter_edit_hint),
282
284
  color = MaterialTheme.colorScheme.onSurfaceVariant,
283
285
  style = MaterialTheme.typography.labelMedium,
284
286
  )
@@ -299,7 +301,7 @@ private fun MainScreenIntroduction(
299
301
  private fun MainScreenFooter(onSocialClick: (String) -> Unit) {
300
302
  Column(verticalArrangement = Arrangement.spacedBy(10.dp)) {
301
303
  Text(
302
- text = "Generated with Nova",
304
+ text = stringResource(R.string.generated_with_nova),
303
305
  color = MaterialTheme.colorScheme.onSurfaceVariant,
304
306
  fontWeight = FontWeight.SemiBold,
305
307
  letterSpacing = 1.1.sp,
@@ -309,43 +311,43 @@ private fun MainScreenFooter(onSocialClick: (String) -> Unit) {
309
311
  Row {
310
312
  MainScreenSocialLink(
311
313
  icon = R.drawable.social_facebook,
312
- label = "Facebook",
314
+ label = R.string.social_facebook,
313
315
  url = "https://www.facebook.com/cbnventures",
314
316
  onSocialClick = onSocialClick,
315
317
  )
316
318
  MainScreenSocialLink(
317
319
  icon = R.drawable.social_x,
318
- label = "X",
320
+ label = R.string.social_x,
319
321
  url = "https://x.com/cbnventures",
320
322
  onSocialClick = onSocialClick,
321
323
  )
322
324
  MainScreenSocialLink(
323
325
  icon = R.drawable.social_youtube,
324
- label = "YouTube",
326
+ label = R.string.social_youtube,
325
327
  url = "https://www.youtube.com/@cbnventures",
326
328
  onSocialClick = onSocialClick,
327
329
  )
328
330
  MainScreenSocialLink(
329
331
  icon = R.drawable.social_instagram,
330
- label = "Instagram",
332
+ label = R.string.social_instagram,
331
333
  url = "https://www.instagram.com/cbnventures/",
332
334
  onSocialClick = onSocialClick,
333
335
  )
334
336
  MainScreenSocialLink(
335
337
  icon = R.drawable.social_github,
336
- label = "GitHub",
338
+ label = R.string.social_github,
337
339
  url = "https://github.com/cbnventures",
338
340
  onSocialClick = onSocialClick,
339
341
  )
340
342
  MainScreenSocialLink(
341
343
  icon = R.drawable.social_google_play,
342
- label = "Google Play",
344
+ label = R.string.social_google_play,
343
345
  url = "https://play.google.com/store/apps/dev?id=6419450160526226105",
344
346
  onSocialClick = onSocialClick,
345
347
  )
346
348
  MainScreenSocialLink(
347
349
  icon = R.drawable.social_linkedin,
348
- label = "LinkedIn",
350
+ label = R.string.social_linkedin,
349
351
  url = "https://www.linkedin.com/company/cbnventures/",
350
352
  onSocialClick = onSocialClick,
351
353
  )
@@ -369,7 +371,7 @@ private fun MainScreenFooter(onSocialClick: (String) -> Unit) {
369
371
  @Composable
370
372
  private fun MainScreenSocialLink(
371
373
  icon: Int,
372
- label: String,
374
+ @StringRes label: Int,
373
375
  url: String,
374
376
  onSocialClick: (String) -> Unit,
375
377
  ) {
@@ -397,7 +399,7 @@ private fun MainScreenSocialLink(
397
399
  Icon(
398
400
  modifier = Modifier.size(18.dp),
399
401
  painter = painterResource(icon),
400
- contentDescription = label,
402
+ contentDescription = stringResource(label),
401
403
  tint = MaterialTheme.colorScheme.onSurfaceVariant,
402
404
  )
403
405
  }
@@ -425,7 +427,7 @@ private fun MainScreenSequence(modifier: Modifier = Modifier) {
425
427
  verticalArrangement = Arrangement.spacedBy(22.dp),
426
428
  ) {
427
429
  Text(
428
- text = "LAUNCH SEQUENCE",
430
+ text = stringResource(R.string.launch_sequence),
429
431
  color = MaterialTheme.colorScheme.onSurfaceVariant,
430
432
  fontWeight = FontWeight.Bold,
431
433
  letterSpacing = 1.2.sp,
@@ -433,21 +435,21 @@ private fun MainScreenSequence(modifier: Modifier = Modifier) {
433
435
  )
434
436
 
435
437
  MainScreenStep(
436
- number = "01",
437
- title = "Shape the experience",
438
- description = "Replace this starter with your first real product experience.",
438
+ number = R.string.launch_step_one_number,
439
+ title = R.string.launch_step_one_title,
440
+ description = R.string.launch_step_one_description,
439
441
  )
440
442
 
441
443
  MainScreenStep(
442
- number = "02",
443
- title = "Keep the contract",
444
- description = "Run the workspace checks while the project takes shape.",
444
+ number = R.string.launch_step_two_number,
445
+ title = R.string.launch_step_two_title,
446
+ description = R.string.launch_step_two_description,
445
447
  )
446
448
 
447
449
  MainScreenStep(
448
- number = "03",
449
- title = "Ship confidently",
450
- description = "Build the same production artifact Nova already validates.",
450
+ number = R.string.launch_step_three_number,
451
+ title = R.string.launch_step_three_title,
452
+ description = R.string.launch_step_three_description,
451
453
  )
452
454
  }
453
455
  }
@@ -465,14 +467,18 @@ private fun MainScreenSequence(modifier: Modifier = Modifier) {
465
467
  * @since UNRELEASED
466
468
  */
467
469
  @Composable
468
- private fun MainScreenStep(number: String, title: String, description: String) {
470
+ private fun MainScreenStep(
471
+ @StringRes number: Int,
472
+ @StringRes title: Int,
473
+ @StringRes description: Int,
474
+ ) {
469
475
  Column(verticalArrangement = Arrangement.spacedBy(4.dp)) {
470
476
  Row(verticalAlignment = Alignment.Top) {
471
477
  Text(
472
478
  modifier =
473
479
  Modifier
474
480
  .width(34.dp),
475
- text = number,
481
+ text = stringResource(number),
476
482
  color = MaterialTheme.colorScheme.primary,
477
483
  fontWeight = FontWeight.Bold,
478
484
  style = MaterialTheme.typography.titleMedium,
@@ -482,7 +488,7 @@ private fun MainScreenStep(number: String, title: String, description: String) {
482
488
  modifier =
483
489
  Modifier
484
490
  .weight(1f),
485
- text = title,
491
+ text = stringResource(title),
486
492
  fontWeight = FontWeight.SemiBold,
487
493
  style = MaterialTheme.typography.titleMedium,
488
494
  )
@@ -490,7 +496,7 @@ private fun MainScreenStep(number: String, title: String, description: String) {
490
496
 
491
497
  Text(
492
498
  modifier = Modifier.padding(start = 34.dp),
493
- text = description,
499
+ text = stringResource(description),
494
500
  color = MaterialTheme.colorScheme.onSurfaceVariant,
495
501
  lineHeight = 20.sp,
496
502
  style = MaterialTheme.typography.bodyMedium,
@@ -530,7 +536,7 @@ private fun MainScreenLoading(modifier: Modifier = Modifier) {
530
536
  private fun MainScreenError(message: String?, modifier: Modifier = Modifier) {
531
537
  Box(modifier = modifier.fillMaxSize(), contentAlignment = Alignment.Center) {
532
538
  Text(
533
- text = message ?: "Unable to load the starter experience.",
539
+ text = message ?: stringResource(R.string.starter_error),
534
540
  color = MaterialTheme.colorScheme.error,
535
541
  textAlign = TextAlign.Center,
536
542
  )
@@ -550,7 +556,7 @@ private fun MainScreenPreview() {
550
556
  [__WORKSPACE_IDENTIFIER__]Theme {
551
557
  Surface {
552
558
  MainScreen(
553
- data = listOf("Android"),
559
+ data = emptyList(),
554
560
  modifier = Modifier.padding(20.dp),
555
561
  )
556
562
  }
@@ -0,0 +1,2 @@
1
+ gradlew text eol=lf
2
+ gradlew.bat text eol=crlf
@@ -10,8 +10,22 @@ import androidx.compose.material3.Surface
10
10
  import androidx.compose.ui.Modifier
11
11
  import [__ANDROID_APPLICATION_ID__].theme.[__WORKSPACE_IDENTIFIER__]Theme
12
12
 
13
- class MainActivity : ComponentActivity() {
14
- override fun onCreate(savedInstanceState: Bundle?) {
13
+ /**
14
+ * Main Activity.
15
+ *
16
+ * Hosts the generated Compose application.
17
+ *
18
+ * @since UNRELEASED
19
+ */
20
+ public class MainActivity : ComponentActivity() {
21
+ /**
22
+ * Main Activity - On Create.
23
+ *
24
+ * @param savedInstanceState - Saved instance state.
25
+ *
26
+ * @since UNRELEASED
27
+ */
28
+ public override fun onCreate(savedInstanceState: Bundle?) {
15
29
  super.onCreate(savedInstanceState)
16
30
 
17
31
  enableEdgeToEdge()
@@ -3,4 +3,10 @@ package [__ANDROID_APPLICATION_ID__]
3
3
  import androidx.navigation3.runtime.NavKey
4
4
  import kotlinx.serialization.Serializable
5
5
 
6
- @Serializable data object Main : NavKey
6
+ /**
7
+ * Main Navigation Key.
8
+ *
9
+ * @since UNRELEASED
10
+ */
11
+ @Serializable
12
+ public data object Main : NavKey
@@ -3,10 +3,34 @@ package [__ANDROID_APPLICATION_ID__].data
3
3
  import kotlinx.coroutines.flow.Flow
4
4
  import kotlinx.coroutines.flow.flow
5
5
 
6
- interface DataRepository {
7
- val data: Flow<List<String>>
6
+ /**
7
+ * Data Repository.
8
+ *
9
+ * Defines the starter data source consumed by the generated launch screen.
10
+ *
11
+ * @since UNRELEASED
12
+ */
13
+ public interface DataRepository {
14
+ /**
15
+ * Data Repository - Data.
16
+ *
17
+ * @since UNRELEASED
18
+ */
19
+ public val data: Flow<List<String>>
8
20
  }
9
21
 
10
- class DefaultDataRepository : DataRepository {
11
- override val data: Flow<List<String>> = flow { emit(listOf("Android")) }
22
+ /**
23
+ * Default Data Repository.
24
+ *
25
+ * Supplies starter data until the generated project adopts a real data source.
26
+ *
27
+ * @since UNRELEASED
28
+ */
29
+ public class DefaultDataRepository : DataRepository {
30
+ /**
31
+ * Default Data Repository - Data.
32
+ *
33
+ * @since UNRELEASED
34
+ */
35
+ public override val data: Flow<List<String>> = flow { emit(listOf("Android")) }
12
36
  }
@@ -2,10 +2,44 @@ package [__ANDROID_APPLICATION_ID__].theme
2
2
 
3
3
  import androidx.compose.ui.graphics.Color
4
4
 
5
- val Purple80 = Color(0xFFD0BCFF)
6
- val PurpleGrey80 = Color(0xFFCCC2DC)
7
- val Pink80 = Color(0xFFEFB8C8)
5
+ /**
6
+ * Purple 80.
7
+ *
8
+ * @since UNRELEASED
9
+ */
10
+ public val Purple80: Color = Color(0xFFD0BCFF)
8
11
 
9
- val Purple40 = Color(0xFF6650a4)
10
- val PurpleGrey40 = Color(0xFF625b71)
11
- val Pink40 = Color(0xFF7D5260)
12
+ /**
13
+ * Purple Grey 80.
14
+ *
15
+ * @since UNRELEASED
16
+ */
17
+ public val PurpleGrey80: Color = Color(0xFFCCC2DC)
18
+
19
+ /**
20
+ * Pink 80.
21
+ *
22
+ * @since UNRELEASED
23
+ */
24
+ public val Pink80: Color = Color(0xFFEFB8C8)
25
+
26
+ /**
27
+ * Purple 40.
28
+ *
29
+ * @since UNRELEASED
30
+ */
31
+ public val Purple40: Color = Color(0xFF6650a4)
32
+
33
+ /**
34
+ * Purple Grey 40.
35
+ *
36
+ * @since UNRELEASED
37
+ */
38
+ public val PurpleGrey40: Color = Color(0xFF625b71)
39
+
40
+ /**
41
+ * Pink 40.
42
+ *
43
+ * @since UNRELEASED
44
+ */
45
+ public val Pink40: Color = Color(0xFF7D5260)
@@ -10,8 +10,20 @@ import androidx.compose.material3.lightColorScheme
10
10
  import androidx.compose.runtime.Composable
11
11
  import androidx.compose.ui.platform.LocalContext
12
12
 
13
+ /**
14
+ * Dark Color Scheme.
15
+ *
16
+ * @private
17
+ * @since UNRELEASED
18
+ */
13
19
  private val DarkColorScheme = darkColorScheme(primary = Purple80, secondary = PurpleGrey80, tertiary = Pink80)
14
20
 
21
+ /**
22
+ * Light Color Scheme.
23
+ *
24
+ * @private
25
+ * @since UNRELEASED
26
+ */
15
27
  private val LightColorScheme =
16
28
  lightColorScheme(
17
29
  primary = Purple40,
@@ -29,8 +41,17 @@ private val LightColorScheme =
29
41
  */
30
42
  )
31
43
 
44
+ /**
45
+ * [__WORKSPACE_TITLE__] Theme.
46
+ *
47
+ * @param darkTheme - Dark theme.
48
+ * @param dynamicColor - Dynamic color.
49
+ * @param content - Content.
50
+ *
51
+ * @since UNRELEASED
52
+ */
32
53
  @Composable
33
- fun [__WORKSPACE_IDENTIFIER__]Theme(
54
+ public fun [__WORKSPACE_IDENTIFIER__]Theme(
34
55
  darkTheme: Boolean = isSystemInDarkTheme(),
35
56
  // Dynamic color is available on Android 12+
36
57
  dynamicColor: Boolean = true,
@@ -6,8 +6,14 @@ import androidx.compose.ui.text.font.FontFamily
6
6
  import androidx.compose.ui.text.font.FontWeight
7
7
  import androidx.compose.ui.unit.sp
8
8
 
9
- // Set of Material typography styles to start with
10
- val Typography =
9
+ /**
10
+ * Typography.
11
+ *
12
+ * Provides the starter Material typography used by the generated application.
13
+ *
14
+ * @since UNRELEASED
15
+ */
16
+ public val Typography: Typography =
11
17
  Typography(
12
18
  bodyLarge =
13
19
  TextStyle(
@@ -10,18 +10,54 @@ import kotlinx.coroutines.flow.catch
10
10
  import kotlinx.coroutines.flow.map
11
11
  import kotlinx.coroutines.flow.stateIn
12
12
 
13
- class MainScreenViewModel(dataRepository: DataRepository) : ViewModel() {
14
- val uiState: StateFlow<MainScreenUiState> =
13
+ /**
14
+ * Main Screen View Model.
15
+ *
16
+ * @param dataRepository - Data repository.
17
+ *
18
+ * @since UNRELEASED
19
+ */
20
+ public class MainScreenViewModel(dataRepository: DataRepository) : ViewModel() {
21
+ /**
22
+ * Main Screen View Model - UI State.
23
+ *
24
+ * @since UNRELEASED
25
+ */
26
+ public val uiState: StateFlow<MainScreenUiState> =
15
27
  dataRepository.data
16
28
  .map<List<String>, MainScreenUiState>(::Success)
17
29
  .catch { emit(MainScreenUiState.Error(it)) }
18
30
  .stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), MainScreenUiState.Loading)
19
31
  }
20
32
 
21
- sealed interface MainScreenUiState {
22
- object Loading : MainScreenUiState
33
+ /**
34
+ * Main Screen UI State.
35
+ *
36
+ * @since UNRELEASED
37
+ */
38
+ public sealed interface MainScreenUiState {
39
+ /**
40
+ * Main Screen UI State - Loading.
41
+ *
42
+ * @since UNRELEASED
43
+ */
44
+ public object Loading : MainScreenUiState
23
45
 
24
- data class Error(val throwable: Throwable) : MainScreenUiState
46
+ /**
47
+ * Main Screen UI State - Error.
48
+ *
49
+ * @param throwable - Throwable.
50
+ *
51
+ * @since UNRELEASED
52
+ */
53
+ public data class Error(public val throwable: Throwable) : MainScreenUiState
25
54
 
26
- data class Success(val data: List<String>) : MainScreenUiState
55
+ /**
56
+ * Main Screen UI State - Success.
57
+ *
58
+ * @param data - Data.
59
+ *
60
+ * @since UNRELEASED
61
+ */
62
+ public data class Success(public val data: List<String>) : MainScreenUiState
27
63
  }
@@ -1,3 +1,30 @@
1
1
  <resources>
2
2
  <string name="app_name">[__WORKSPACE_TITLE__]</string>
3
+ <string name="explore_android_docs">Explore Android docs</string>
4
+ <string name="generated_with_nova">Generated with Nova</string>
5
+ <string name="launch_sequence">Launch sequence</string>
6
+ <string name="launch_step_one_description">Replace this starter with your first real product experience.</string>
7
+ <string name="launch_step_one_number">01</string>
8
+ <string name="launch_step_one_title">Shape the experience</string>
9
+ <string name="launch_step_three_description">Build the same production artifact Nova already validates.</string>
10
+ <string name="launch_step_three_number">03</string>
11
+ <string name="launch_step_three_title">Ship confidently</string>
12
+ <string name="launch_step_two_description">Run the workspace checks while the project takes shape.</string>
13
+ <string name="launch_step_two_number">02</string>
14
+ <string name="launch_step_two_title">Keep the contract</string>
15
+ <string name="nova_logo_content_description">Nova</string>
16
+ <string name="nova_platform_name">Nova × %1$s</string>
17
+ <string name="platform_android">Android</string>
18
+ <string name="read_nova_docs">Read Nova Docs</string>
19
+ <string name="social_facebook">Facebook</string>
20
+ <string name="social_github">GitHub</string>
21
+ <string name="social_google_play">Google Play</string>
22
+ <string name="social_instagram">Instagram</string>
23
+ <string name="social_linkedin">LinkedIn</string>
24
+ <string name="social_x">X</string>
25
+ <string name="social_youtube">YouTube</string>
26
+ <string name="starter_description">A native Android workspace with strict checks, tests, and a clean path from first screen to release.</string>
27
+ <string name="starter_edit_hint">Start in ui/main/MainScreen.kt</string>
28
+ <string name="starter_error">Unable to load the starter experience.</string>
29
+ <string name="starter_title">[__WORKSPACE_TITLE__] starts here.</string>
3
30
  </resources>