@mrpatronz/nexusflow 0.2.12 → 0.2.17

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 (233) hide show
  1. package/.github/dependabot.yml +52 -52
  2. package/.github/workflows/dependabot-merge.yml +53 -0
  3. package/.github/workflows/release.yml +112 -100
  4. package/.vscode/launch.json +17 -17
  5. package/.vscode/tasks.json +17 -17
  6. package/GETTING_STARTED.md +114 -109
  7. package/README.md +336 -311
  8. package/desktop/build-installer.js +228 -0
  9. package/desktop/build.js +118 -0
  10. package/desktop/installer/nexusflow.iss +35 -0
  11. package/desktop/neutralino.config.json +39 -0
  12. package/desktop/package-lock.json +1060 -0
  13. package/desktop/package.json +14 -0
  14. package/dist/commands/add-repo.d.ts.map +1 -1
  15. package/dist/commands/add-repo.js +24 -14
  16. package/dist/commands/add-repo.js.map +1 -1
  17. package/dist/commands/commit.js +1 -1
  18. package/dist/commands/commit.js.map +1 -1
  19. package/dist/commands/desktop.d.ts +12 -0
  20. package/dist/commands/desktop.d.ts.map +1 -0
  21. package/dist/commands/desktop.js +119 -0
  22. package/dist/commands/desktop.js.map +1 -0
  23. package/dist/commands/diff.js +1 -1
  24. package/dist/commands/diff.js.map +1 -1
  25. package/dist/commands/doctor.js +1 -1
  26. package/dist/commands/doctor.js.map +1 -1
  27. package/dist/commands/handoff.js +1 -1
  28. package/dist/commands/handoff.js.map +1 -1
  29. package/dist/commands/logs.js +1 -1
  30. package/dist/commands/logs.js.map +1 -1
  31. package/dist/commands/open.d.ts.map +1 -1
  32. package/dist/commands/open.js +12 -7
  33. package/dist/commands/open.js.map +1 -1
  34. package/dist/commands/pack.js +1 -1
  35. package/dist/commands/pack.js.map +1 -1
  36. package/dist/commands/refresh.js +13 -8
  37. package/dist/commands/refresh.js.map +1 -1
  38. package/dist/commands/remove.d.ts.map +1 -1
  39. package/dist/commands/remove.js +12 -7
  40. package/dist/commands/remove.js.map +1 -1
  41. package/dist/commands/start.js +1 -1
  42. package/dist/commands/start.js.map +1 -1
  43. package/dist/commands/status.js +1 -1
  44. package/dist/commands/status.js.map +1 -1
  45. package/dist/commands/stop.js +1 -1
  46. package/dist/commands/stop.js.map +1 -1
  47. package/dist/commands/sync.d.ts.map +1 -1
  48. package/dist/commands/sync.js +14 -11
  49. package/dist/commands/sync.js.map +1 -1
  50. package/dist/commands/tui.d.ts +8 -0
  51. package/dist/commands/tui.d.ts.map +1 -0
  52. package/dist/commands/tui.js +386 -0
  53. package/dist/commands/tui.js.map +1 -0
  54. package/dist/commands/ui.d.ts +3 -1
  55. package/dist/commands/ui.d.ts.map +1 -1
  56. package/dist/commands/ui.js +76 -19
  57. package/dist/commands/ui.js.map +1 -1
  58. package/dist/core/workspace.d.ts +7 -0
  59. package/dist/core/workspace.d.ts.map +1 -1
  60. package/dist/core/workspace.js +45 -1
  61. package/dist/core/workspace.js.map +1 -1
  62. package/dist/generators/base.d.ts.map +1 -1
  63. package/dist/generators/base.js +78 -66
  64. package/dist/generators/base.js.map +1 -1
  65. package/dist/generators/codex.js +11 -11
  66. package/dist/generators/copilot.js +17 -17
  67. package/dist/generators/cursor.js +5 -5
  68. package/dist/generators/index.d.ts.map +1 -1
  69. package/dist/generators/index.js +64 -50
  70. package/dist/generators/index.js.map +1 -1
  71. package/dist/generators/map-generator.js +14 -14
  72. package/dist/generators/skills-generator.js +28 -28
  73. package/dist/gui/app_logo.png +0 -0
  74. package/dist/gui/assets/index-Ct3qq-X4.js +25 -0
  75. package/dist/gui/assets/index-P_ZrgHXg.css +1 -0
  76. package/dist/gui/icons.svg +24 -24
  77. package/dist/gui/index.html +18 -18
  78. package/dist/index.js +43 -0
  79. package/dist/index.js.map +1 -1
  80. package/dist/orchestration/runner.d.ts +5 -6
  81. package/dist/orchestration/runner.d.ts.map +1 -1
  82. package/dist/orchestration/runner.js +105 -102
  83. package/dist/orchestration/runner.js.map +1 -1
  84. package/dist/server.d.ts.map +1 -1
  85. package/dist/server.js +235 -2
  86. package/dist/server.js.map +1 -1
  87. package/dist/server.test.js +78 -0
  88. package/dist/server.test.js.map +1 -1
  89. package/dist/types.d.ts +4 -0
  90. package/dist/types.d.ts.map +1 -1
  91. package/dist/utils/detect-editors.js +1 -1
  92. package/dist/utils/detect-editors.js.map +1 -1
  93. package/dist/utils/detect-editors.test.js +3 -3
  94. package/dist/utils/detect-editors.test.js.map +1 -1
  95. package/dist/utils/git.d.ts +16 -0
  96. package/dist/utils/git.d.ts.map +1 -1
  97. package/dist/utils/git.js +52 -0
  98. package/dist/utils/git.js.map +1 -1
  99. package/dist/utils/multi-git.d.ts +2 -0
  100. package/dist/utils/multi-git.d.ts.map +1 -1
  101. package/dist/utils/multi-git.js +5 -2
  102. package/dist/utils/multi-git.js.map +1 -1
  103. package/dist/utils/prompts.d.ts +1 -0
  104. package/dist/utils/prompts.d.ts.map +1 -1
  105. package/dist/utils/prompts.js +77 -15
  106. package/dist/utils/prompts.js.map +1 -1
  107. package/dist/utils/update-check.d.ts +3 -1
  108. package/dist/utils/update-check.d.ts.map +1 -1
  109. package/dist/utils/update-check.js +23 -6
  110. package/dist/utils/update-check.js.map +1 -1
  111. package/dist/utils/workflows.d.ts +11 -0
  112. package/dist/utils/workflows.d.ts.map +1 -0
  113. package/dist/utils/workflows.js +156 -0
  114. package/dist/utils/workflows.js.map +1 -0
  115. package/dist/utils/workflows.test.d.ts +2 -0
  116. package/dist/utils/workflows.test.d.ts.map +1 -0
  117. package/dist/utils/workflows.test.js +86 -0
  118. package/dist/utils/workflows.test.js.map +1 -0
  119. package/extension/media/icon.svg +1 -0
  120. package/extension/package-lock.json +2673 -2811
  121. package/extension/package.json +108 -61
  122. package/extension/src/extension.ts +631 -168
  123. package/extension/tsconfig.json +21 -19
  124. package/gui/README.md +73 -73
  125. package/gui/e2e/wizard.spec.ts +346 -327
  126. package/gui/eslint.config.js +26 -22
  127. package/gui/index.html +17 -17
  128. package/gui/package-lock.json +3079 -3118
  129. package/gui/package.json +36 -36
  130. package/gui/playwright.config.ts +41 -41
  131. package/gui/public/app_logo.png +0 -0
  132. package/gui/public/icons.svg +24 -24
  133. package/gui/src/App.css +1 -1
  134. package/gui/src/App.tsx +3407 -2498
  135. package/gui/src/assets/vite.svg +1 -1
  136. package/gui/src/features/changes/ChangesViewer.tsx +388 -212
  137. package/gui/src/features/knowledge/KnowledgeBase.tsx +84 -84
  138. package/gui/src/features/onboarding/OnboardingWizard.tsx +230 -230
  139. package/gui/src/features/plan/ImplementationPlan.tsx +32 -32
  140. package/gui/src/features/services/ServiceConsole.tsx +250 -159
  141. package/gui/src/features/sessions/SessionHistory.tsx +195 -195
  142. package/gui/src/features/workspace/WorkspaceList.tsx +666 -514
  143. package/gui/src/index.css +152 -17
  144. package/gui/src/main.tsx +94 -10
  145. package/gui/src/types.ts +62 -62
  146. package/gui/tsconfig.app.json +25 -25
  147. package/gui/tsconfig.json +7 -7
  148. package/gui/tsconfig.node.json +24 -24
  149. package/gui/vite.config.ts +12 -12
  150. package/package.json +56 -55
  151. package/resources/workflows/plan-implement-review.md +8 -0
  152. package/resources/workflows/research-verify.md +6 -0
  153. package/resources/workflows/solo-developer.md +3 -0
  154. package/scripts/simulate-workspaces.ts +55 -55
  155. package/src/analyzers/detect-apis.ts +290 -290
  156. package/src/analyzers/detect-deps.ts +315 -315
  157. package/src/analyzers/detect-existing.ts +74 -74
  158. package/src/analyzers/detect-ports.ts +110 -110
  159. package/src/analyzers/index.ts +97 -97
  160. package/src/analyzers/messaging-analyzer.ts +254 -254
  161. package/src/analyzers/readme-summarizer.ts +102 -102
  162. package/src/analyzers/run-analyzer.ts +269 -269
  163. package/src/analyzers/tech-stack.ts +283 -283
  164. package/src/commands/add-repo.ts +157 -141
  165. package/src/commands/commands.test.ts +155 -155
  166. package/src/commands/commit.ts +131 -131
  167. package/src/commands/create.ts +207 -207
  168. package/src/commands/desktop.ts +128 -0
  169. package/src/commands/diff.ts +125 -125
  170. package/src/commands/doctor.ts +357 -357
  171. package/src/commands/handoff.ts +266 -266
  172. package/src/commands/init.ts +134 -134
  173. package/src/commands/list.ts +46 -46
  174. package/src/commands/logs.ts +63 -63
  175. package/src/commands/mcp.ts +92 -92
  176. package/src/commands/open.ts +129 -121
  177. package/src/commands/pack.ts +73 -73
  178. package/src/commands/refresh.ts +147 -139
  179. package/src/commands/remove.ts +98 -90
  180. package/src/commands/start.ts +117 -117
  181. package/src/commands/status.ts +54 -54
  182. package/src/commands/stop.ts +55 -55
  183. package/src/commands/sync.ts +151 -145
  184. package/src/commands/tui.ts +424 -0
  185. package/src/commands/ui.ts +111 -47
  186. package/src/core/config.test.ts +96 -96
  187. package/src/core/config.ts +115 -115
  188. package/src/core/graph.ts +344 -344
  189. package/src/core/packer.test.ts +99 -99
  190. package/src/core/packer.ts +107 -107
  191. package/src/core/scanner.test.ts +61 -61
  192. package/src/core/scanner.ts +91 -91
  193. package/src/core/workspace.ts +380 -333
  194. package/src/core/worktree.ts +120 -120
  195. package/src/generators/antigravity.ts +32 -32
  196. package/src/generators/base.ts +240 -227
  197. package/src/generators/claude.ts +34 -34
  198. package/src/generators/codex.ts +48 -48
  199. package/src/generators/copilot.ts +56 -56
  200. package/src/generators/cursor.ts +44 -44
  201. package/src/generators/index.ts +250 -230
  202. package/src/generators/map-generator.test.ts +159 -159
  203. package/src/generators/map-generator.ts +542 -542
  204. package/src/generators/plan-generator.ts +481 -481
  205. package/src/generators/skills-generator.ts +259 -259
  206. package/src/index.ts +426 -382
  207. package/src/mcp/server.ts +294 -294
  208. package/src/orchestration/detect.ts +313 -313
  209. package/src/orchestration/index.ts +7 -7
  210. package/src/orchestration/runner.ts +283 -279
  211. package/src/server.test.ts +555 -464
  212. package/src/server.ts +1308 -1047
  213. package/src/types.ts +408 -403
  214. package/src/utils/detect-ai.test.ts +44 -44
  215. package/src/utils/detect-ai.ts +84 -84
  216. package/src/utils/detect-editors.test.ts +48 -48
  217. package/src/utils/detect-editors.ts +57 -57
  218. package/src/utils/git.test.ts +74 -74
  219. package/src/utils/git.ts +117 -61
  220. package/src/utils/local-ai.test.ts +130 -130
  221. package/src/utils/local-ai.ts +111 -111
  222. package/src/utils/multi-git.ts +313 -306
  223. package/src/utils/prompts.ts +209 -135
  224. package/src/utils/session-finder.ts +483 -483
  225. package/src/utils/system-scanner.test.ts +89 -89
  226. package/src/utils/system-scanner.ts +96 -96
  227. package/src/utils/update-check.ts +309 -275
  228. package/src/utils/workflows.test.ts +114 -0
  229. package/src/utils/workflows.ts +178 -0
  230. package/tsconfig.json +19 -19
  231. package/vitest.config.ts +14 -14
  232. package/dist/gui/assets/index-Ca2VRMrQ.js +0 -22
  233. package/dist/gui/assets/index-fj0RJiOb.css +0 -2
@@ -1,84 +1,84 @@
1
- import React from 'react';
2
- import { BookOpen, RefreshCw, Save, Edit } from 'lucide-react';
3
- import type { Feature } from '../../types.js';
4
-
5
- interface KnowledgeBaseProps {
6
- ws: Feature;
7
- knowledgeContent: string;
8
- knowledgeLoading: boolean;
9
- isEditingKnowledge: boolean;
10
- editedKnowledge: string;
11
- saveKnowledgeLoading: boolean;
12
- setEditedKnowledge: (val: string) => void;
13
- setIsEditingKnowledge: (val: boolean) => void;
14
- handleSaveKnowledge: (wsId: string) => Promise<void>;
15
- }
16
-
17
- export const KnowledgeBase: React.FC<KnowledgeBaseProps> = ({
18
- ws,
19
- knowledgeContent,
20
- knowledgeLoading,
21
- isEditingKnowledge,
22
- editedKnowledge,
23
- saveKnowledgeLoading,
24
- setEditedKnowledge,
25
- setIsEditingKnowledge,
26
- handleSaveKnowledge,
27
- }) => {
28
- return (
29
- <div className="bg-[#090d1a]/20 border border-gray-800/60 rounded-xl p-4">
30
- <header className="flex justify-between items-center mb-4">
31
- <h4 className="text-sm font-bold text-white flex items-center gap-2">
32
- <BookOpen size={16} className="text-cyan-400" /> Persistent Knowledge Memory (nexusflow-knowledge.md)
33
- </h4>
34
- <div className="flex gap-2">
35
- {isEditingKnowledge ? (
36
- <>
37
- <button
38
- className="px-2.5 py-1.5 bg-gray-900 border border-gray-800 hover:bg-gray-850 rounded-lg text-[10px] font-semibold transition-all cursor-pointer text-gray-400"
39
- onClick={() => {
40
- setEditedKnowledge(knowledgeContent);
41
- setIsEditingKnowledge(false);
42
- }}
43
- disabled={saveKnowledgeLoading}
44
- >
45
- Cancel
46
- </button>
47
- <button
48
- className="inline-flex items-center gap-1.5 px-2.5 py-1.5 bg-indigo-650 hover:bg-indigo-600 text-white rounded-lg text-[10px] font-semibold transition-all cursor-pointer"
49
- onClick={() => handleSaveKnowledge(ws.branchName)}
50
- disabled={saveKnowledgeLoading}
51
- >
52
- {saveKnowledgeLoading ? <RefreshCw className="animate-spin" size={10} /> : <Save size={10} />} Save
53
- </button>
54
- </>
55
- ) : (
56
- <button
57
- className="inline-flex items-center gap-1.5 px-2.5 py-1.5 bg-gray-900 border border-gray-800 hover:bg-gray-800 hover:border-gray-700 rounded-lg text-[10px] font-semibold transition-all cursor-pointer text-gray-350"
58
- onClick={() => setIsEditingKnowledge(true)}
59
- disabled={knowledgeLoading}
60
- >
61
- <Edit size={10} /> Edit Knowledge
62
- </button>
63
- )}
64
- </div>
65
- </header>
66
-
67
- {knowledgeLoading ? (
68
- <div className="flex justify-center py-10">
69
- <RefreshCw className="animate-spin text-indigo-400" size={20} />
70
- </div>
71
- ) : isEditingKnowledge ? (
72
- <textarea
73
- className="w-full h-96 bg-gray-950/60 border border-gray-800/80 rounded-xl p-4 text-xs font-mono text-gray-305 focus:outline-none focus:border-indigo-500/80 resize-y"
74
- value={editedKnowledge}
75
- onChange={(e) => setEditedKnowledge(e.target.value)}
76
- />
77
- ) : (
78
- <div className="bg-gray-950/40 border border-gray-800/30 rounded-xl p-4 text-gray-350 text-xs leading-relaxed overflow-auto font-mono whitespace-pre-wrap max-h-96">
79
- {knowledgeContent || "No knowledge file generated yet."}
80
- </div>
81
- )}
82
- </div>
83
- );
84
- };
1
+ import React from 'react';
2
+ import { BookOpen, RefreshCw, Save, Edit } from 'lucide-react';
3
+ import type { Feature } from '../../types.js';
4
+
5
+ interface KnowledgeBaseProps {
6
+ ws: Feature;
7
+ knowledgeContent: string;
8
+ knowledgeLoading: boolean;
9
+ isEditingKnowledge: boolean;
10
+ editedKnowledge: string;
11
+ saveKnowledgeLoading: boolean;
12
+ setEditedKnowledge: (val: string) => void;
13
+ setIsEditingKnowledge: (val: boolean) => void;
14
+ handleSaveKnowledge: (wsId: string) => Promise<void>;
15
+ }
16
+
17
+ export const KnowledgeBase: React.FC<KnowledgeBaseProps> = ({
18
+ ws,
19
+ knowledgeContent,
20
+ knowledgeLoading,
21
+ isEditingKnowledge,
22
+ editedKnowledge,
23
+ saveKnowledgeLoading,
24
+ setEditedKnowledge,
25
+ setIsEditingKnowledge,
26
+ handleSaveKnowledge,
27
+ }) => {
28
+ return (
29
+ <div className="bg-[#090d1a]/20 border border-gray-800/60 rounded-xl p-4">
30
+ <header className="flex justify-between items-center mb-4">
31
+ <h4 className="text-sm font-bold text-white flex items-center gap-2">
32
+ <BookOpen size={16} className="text-cyan-400" /> Persistent Knowledge Memory (nexusflow-knowledge.md)
33
+ </h4>
34
+ <div className="flex gap-2">
35
+ {isEditingKnowledge ? (
36
+ <>
37
+ <button
38
+ className="px-2.5 py-1.5 bg-gray-900 border border-gray-800 hover:bg-gray-850 rounded-lg text-[10px] font-semibold transition-all cursor-pointer text-gray-400"
39
+ onClick={() => {
40
+ setEditedKnowledge(knowledgeContent);
41
+ setIsEditingKnowledge(false);
42
+ }}
43
+ disabled={saveKnowledgeLoading}
44
+ >
45
+ Cancel
46
+ </button>
47
+ <button
48
+ className="inline-flex items-center gap-1.5 px-2.5 py-1.5 bg-indigo-650 hover:bg-indigo-600 text-white rounded-lg text-[10px] font-semibold transition-all cursor-pointer"
49
+ onClick={() => handleSaveKnowledge(ws.branchName)}
50
+ disabled={saveKnowledgeLoading}
51
+ >
52
+ {saveKnowledgeLoading ? <RefreshCw className="animate-spin" size={10} /> : <Save size={10} />} Save
53
+ </button>
54
+ </>
55
+ ) : (
56
+ <button
57
+ className="inline-flex items-center gap-1.5 px-2.5 py-1.5 bg-gray-900 border border-gray-800 hover:bg-gray-800 hover:border-gray-700 rounded-lg text-[10px] font-semibold transition-all cursor-pointer text-gray-350"
58
+ onClick={() => setIsEditingKnowledge(true)}
59
+ disabled={knowledgeLoading}
60
+ >
61
+ <Edit size={10} /> Edit Knowledge
62
+ </button>
63
+ )}
64
+ </div>
65
+ </header>
66
+
67
+ {knowledgeLoading ? (
68
+ <div className="flex justify-center py-10">
69
+ <RefreshCw className="animate-spin text-indigo-400" size={20} />
70
+ </div>
71
+ ) : isEditingKnowledge ? (
72
+ <textarea
73
+ className="w-full h-96 bg-gray-950/60 border border-gray-800/80 rounded-xl p-4 text-xs font-mono text-gray-305 focus:outline-none focus:border-indigo-500/80 resize-y"
74
+ value={editedKnowledge}
75
+ onChange={(e) => setEditedKnowledge(e.target.value)}
76
+ />
77
+ ) : (
78
+ <div className="bg-gray-950/40 border border-gray-800/30 rounded-xl p-4 text-gray-350 text-xs leading-relaxed overflow-auto font-mono whitespace-pre-wrap max-h-96">
79
+ {knowledgeContent || "No knowledge file generated yet."}
80
+ </div>
81
+ )}
82
+ </div>
83
+ );
84
+ };
@@ -1,230 +1,230 @@
1
- import React from 'react';
2
- import { Sparkles, Settings as SettingsIcon, ArrowRight } from 'lucide-react';
3
- import type { NexusFlowConfig } from '../../types.js';
4
-
5
- interface OnboardingWizardProps {
6
- config: NexusFlowConfig;
7
- defaultPaths: { devDir: string; workspacesDir: string } | null;
8
- setConfig: (cfg: NexusFlowConfig) => void;
9
- saveAppConfig: (cfg: NexusFlowConfig) => Promise<void>;
10
- }
11
-
12
- export const OnboardingWizard: React.FC<OnboardingWizardProps> = ({
13
- config,
14
- defaultPaths,
15
- setConfig,
16
- saveAppConfig,
17
- }) => {
18
- const isFormValid = config.devDir.trim() !== '' && config.workspacesDir.trim() !== '';
19
-
20
- return (
21
- <div className="flex min-h-screen bg-[#070913] text-gray-100 font-sans items-center justify-center p-6 bg-gradient-to-br from-[#0c0f24] via-[#070913] to-[#04050b]">
22
- {/* Onboarding Box */}
23
- <div className="max-w-6xl w-full bg-[#111827]/40 border border-gray-800/80 rounded-2xl p-8 backdrop-blur-md shadow-2xl grid grid-cols-1 lg:grid-cols-12 gap-10">
24
-
25
- {/* Left Column: Onboarding Guide & Concepts */}
26
- <div className="lg:col-span-7 flex flex-col justify-between">
27
- <div>
28
- <div className="inline-flex items-center gap-1.5 px-3 py-1 rounded-full bg-indigo-500/10 text-indigo-400 border border-indigo-500/20 text-xs font-semibold uppercase tracking-wider mb-4">
29
- <Sparkles size={12} className="text-cyan-400 animate-pulse" /> Onboarding Guide
30
- </div>
31
- <h1 className="text-3xl font-extrabold tracking-tight text-white mb-2 bg-gradient-to-r from-white via-gray-200 to-indigo-300 bg-clip-text text-transparent">
32
- Welcome to NexusFlow
33
- </h1>
34
- <p className="text-sm text-gray-400 mb-8 max-w-xl">
35
- NexusFlow orchestrates multi-repository developer environments. It combines isolated Git worktrees, automatic code analyzer sweeps, and background process running into a single dashboard.
36
- </p>
37
-
38
- {/* Onboarding Steps */}
39
- <div className="space-y-6">
40
- <div className="flex gap-4">
41
- <div className="w-8 h-8 rounded-full bg-indigo-500/10 border border-indigo-500/20 text-indigo-400 flex items-center justify-center font-bold text-sm shrink-0">
42
- 1
43
- </div>
44
- <div>
45
- <h3 className="text-sm font-semibold text-white">Configure Development Folders</h3>
46
- <p className="text-xs text-gray-400 mt-1">
47
- Specify your local code path and target workspaces path. For the first setup, these paths start empty so you can explicitly configure them.
48
- </p>
49
- </div>
50
- </div>
51
-
52
- <div className="flex gap-4">
53
- <div className="w-8 h-8 rounded-full bg-indigo-500/10 border border-indigo-500/20 text-indigo-400 flex items-center justify-center font-bold text-sm shrink-0">
54
- 2
55
- </div>
56
- <div>
57
- <h3 className="text-sm font-semibold text-white">Build Isolated Branch Workspaces</h3>
58
- <p className="text-xs text-gray-400 mt-1">
59
- Choose repositories and input your feature branch. NexusFlow runs <code>git worktree</code> to checkout dependencies under a unified folder structure, leaving your primary repository directories clean.
60
- </p>
61
- </div>
62
- </div>
63
-
64
- <div className="flex gap-4">
65
- <div className="w-8 h-8 rounded-full bg-indigo-500/10 border border-indigo-500/20 text-indigo-400 flex items-center justify-center font-bold text-sm shrink-0">
66
- 3
67
- </div>
68
- <div>
69
- <h3 className="text-sm font-semibold text-white">Align AI Coding Contexts</h3>
70
- <p className="text-xs text-gray-400 mt-1">
71
- NexusFlow automatically generates configuration files (<code>CLAUDE.md</code>, <code>.cursorrules</code>, <code>AGENTS.md</code>) that instruct the AI assistant to analyze project inter-dependencies, document its assumptions in <code>nexusflow-overview.md</code>, and highlight clarifying questions.
72
- </p>
73
- </div>
74
- </div>
75
-
76
- <div className="flex gap-4">
77
- <div className="w-8 h-8 rounded-full bg-indigo-500/10 border border-indigo-500/20 text-indigo-400 flex items-center justify-center font-bold text-sm shrink-0">
78
- 4
79
- </div>
80
- <div>
81
- <h3 className="text-sm font-semibold text-white">Orchestrate Background Services</h3>
82
- <p className="text-xs text-gray-400 mt-1">
83
- Run APIs, database scripts, and frontend watch tasks concurrently from the web portal. Monitor real-time logs inside a unified terminal pane.
84
- </p>
85
- </div>
86
- </div>
87
- </div>
88
- </div>
89
-
90
- {/* Comparison Dashboard */}
91
- <div className="mt-8 pt-6 border-t border-gray-800/80">
92
- <h4 className="text-xs font-semibold uppercase tracking-wider text-gray-500 mb-3">Industry Comparison</h4>
93
- <div className="overflow-x-auto font-sans">
94
- <table className="w-full text-[10px] text-gray-400 text-left border-collapse">
95
- <thead>
96
- <tr className="border-b border-gray-800 text-gray-500">
97
- <th className="py-2 pr-4 font-semibold">Orchestrator</th>
98
- <th className="py-2 px-4 font-semibold">Multi-Repo</th>
99
- <th className="py-2 px-4 font-semibold">AI Rules Integration</th>
100
- <th className="py-2 pl-4 font-semibold">Weight</th>
101
- </tr>
102
- </thead>
103
- <tbody>
104
- <tr className="border-b border-gray-800/40">
105
- <td className="py-2 pr-4 font-semibold text-white">Docker Compose</td>
106
- <td className="py-2 px-4">Yes (Containers only)</td>
107
- <td className="py-2 px-4">No</td>
108
- <td className="py-2 pl-4">Medium (VM overhead)</td>
109
- </tr>
110
- <tr className="border-b border-gray-800/40">
111
- <td className="py-2 pr-4 font-semibold text-white">Lerna / Turborepo</td>
112
- <td className="py-2 px-4">Monorepo only</td>
113
- <td className="py-2 px-4">No</td>
114
- <td className="py-2 pl-4">Light</td>
115
- </tr>
116
- <tr className="border-b border-gray-800/40">
117
- <td className="py-2 pr-4 font-semibold text-white">DevPod / Gitpod</td>
118
- <td className="py-2 px-4">Yes (Complex config)</td>
119
- <td className="py-2 px-4">No</td>
120
- <td className="py-2 pl-4">Heavy (Full virtual VM)</td>
121
- </tr>
122
- <tr>
123
- <td className="py-2 pr-4 font-semibold text-indigo-400">NexusFlow</td>
124
- <td className="py-2 px-4 text-indigo-300">Yes (Native Worktrees)</td>
125
- <td className="py-2 px-4 text-indigo-300">Yes (CLAUDE.md/MDC rules)</td>
126
- <td className="py-2 pl-4 text-indigo-300">Extremely Light (Native processes)</td>
127
- </tr>
128
- </tbody>
129
- </table>
130
- </div>
131
- </div>
132
- </div>
133
-
134
- {/* Right Column: Configuration Form */}
135
- <div className="lg:col-span-5 flex flex-col justify-center">
136
- <div className="bg-gray-950/40 border border-gray-800/80 rounded-2xl p-6 shadow-lg">
137
- <h2 className="text-xl font-bold text-white mb-1 flex items-center gap-2">
138
- <SettingsIcon className="text-indigo-400 animate-spin-slow" size={20} /> Initialize Config
139
- </h2>
140
- <p className="text-xs text-gray-500 mb-6">
141
- Define the directories on your machine. The fields are empty so you can provide your paths.
142
- </p>
143
-
144
- {/* Form Input fields */}
145
- <div className="space-y-5">
146
- <div>
147
- <label className="block text-[11px] font-semibold text-gray-400 uppercase tracking-wider mb-2">Development Directory</label>
148
- <input
149
- type="text"
150
- className="w-full bg-[#111827] border border-gray-800 focus:border-indigo-500 focus:ring-1 focus:ring-indigo-500 rounded-lg px-4 py-3 text-white placeholder-gray-600 transition-all outline-none text-xs shadow-inner"
151
- placeholder="e.g. C:\Users\username\dev"
152
- value={config.devDir}
153
- onChange={(e) => setConfig({ ...config, devDir: e.target.value })}
154
- />
155
- {defaultPaths && (
156
- <div className="text-[10px] text-gray-500 mt-1.5 flex justify-between items-center">
157
- <span>Suggested: <code>{defaultPaths.devDir}</code></span>
158
- </div>
159
- )}
160
- </div>
161
-
162
- <div>
163
- <label className="block text-[11px] font-semibold text-gray-400 uppercase tracking-wider mb-2">Workspaces Directory</label>
164
- <input
165
- type="text"
166
- className="w-full bg-[#111827] border border-gray-800 focus:border-indigo-500 focus:ring-1 focus:ring-indigo-500 rounded-lg px-4 py-3 text-white placeholder-gray-600 transition-all outline-none text-xs shadow-inner"
167
- placeholder="e.g. C:\Users\username\dev\workspaces"
168
- value={config.workspacesDir}
169
- onChange={(e) => setConfig({ ...config, workspacesDir: e.target.value })}
170
- />
171
- {defaultPaths && (
172
- <div className="text-[10px] text-gray-500 mt-1.5 flex justify-between items-center">
173
- <span>Suggested: <code>{defaultPaths.workspacesDir}</code></span>
174
- </div>
175
- )}
176
- </div>
177
-
178
- {/* Form Buttons */}
179
- <div className="flex gap-2 pt-2">
180
- <button
181
- type="button"
182
- className="flex-1 inline-flex items-center justify-center gap-1.5 px-3 py-2 bg-gray-900 border border-gray-800 hover:bg-gray-800 hover:border-gray-700 rounded-lg text-xs font-semibold transition-all cursor-pointer"
183
- onClick={() => {
184
- if (defaultPaths) {
185
- setConfig({
186
- ...config,
187
- devDir: defaultPaths.devDir,
188
- workspacesDir: defaultPaths.workspacesDir,
189
- });
190
- }
191
- }}
192
- >
193
- Suggest Defaults
194
- </button>
195
- <button
196
- type="button"
197
- className="px-3 py-2 bg-gray-900 border border-gray-800 hover:bg-gray-800 hover:border-rose-900/60 hover:text-rose-400 rounded-lg text-xs font-semibold transition-all cursor-pointer"
198
- onClick={() => {
199
- setConfig({
200
- ...config,
201
- devDir: '',
202
- workspacesDir: '',
203
- version: config.version,
204
- defaultAssistant: config.defaultAssistant,
205
- scanDepth: config.scanDepth,
206
- });
207
- }}
208
- >
209
- Clear
210
- </button>
211
- </div>
212
-
213
- {/* Save Button */}
214
- <div className="pt-4">
215
- <button
216
- type="button"
217
- className="w-full inline-flex items-center justify-center gap-2 px-5 py-3 rounded-lg text-sm font-semibold bg-gradient-to-r from-indigo-500 to-indigo-600 hover:from-indigo-600 hover:to-indigo-700 text-white shadow-lg shadow-indigo-500/20 hover:-translate-y-0.5 active:translate-y-0 disabled:opacity-40 disabled:cursor-not-allowed disabled:hover:translate-y-0 transition-all cursor-pointer"
218
- disabled={!isFormValid}
219
- onClick={() => saveAppConfig(config)}
220
- >
221
- Save & Get Started <ArrowRight size={16} />
222
- </button>
223
- </div>
224
- </div>
225
- </div>
226
- </div>
227
- </div>
228
- </div>
229
- );
230
- };
1
+ import React from 'react';
2
+ import { Sparkles, Settings as SettingsIcon, ArrowRight } from 'lucide-react';
3
+ import type { NexusFlowConfig } from '../../types.js';
4
+
5
+ interface OnboardingWizardProps {
6
+ config: NexusFlowConfig;
7
+ defaultPaths: { devDir: string; workspacesDir: string } | null;
8
+ setConfig: (cfg: NexusFlowConfig) => void;
9
+ saveAppConfig: (cfg: NexusFlowConfig) => Promise<void>;
10
+ }
11
+
12
+ export const OnboardingWizard: React.FC<OnboardingWizardProps> = ({
13
+ config,
14
+ defaultPaths,
15
+ setConfig,
16
+ saveAppConfig,
17
+ }) => {
18
+ const isFormValid = config.devDir.trim() !== '' && config.workspacesDir.trim() !== '';
19
+
20
+ return (
21
+ <div className="flex min-h-screen bg-[#070913] text-gray-100 font-sans items-center justify-center p-6 bg-gradient-to-br from-[#0c0f24] via-[#070913] to-[#04050b]">
22
+ {/* Onboarding Box */}
23
+ <div className="max-w-6xl w-full bg-[#111827]/40 border border-gray-800/80 rounded-2xl p-8 backdrop-blur-md shadow-2xl grid grid-cols-1 lg:grid-cols-12 gap-10">
24
+
25
+ {/* Left Column: Onboarding Guide & Concepts */}
26
+ <div className="lg:col-span-7 flex flex-col justify-between">
27
+ <div>
28
+ <div className="inline-flex items-center gap-1.5 px-3 py-1 rounded-full bg-indigo-500/10 text-indigo-400 border border-indigo-500/20 text-xs font-semibold uppercase tracking-wider mb-4">
29
+ <Sparkles size={12} className="text-cyan-400 animate-pulse" /> Onboarding Guide
30
+ </div>
31
+ <h1 className="text-3xl font-extrabold tracking-tight text-white mb-2 bg-gradient-to-r from-white via-gray-200 to-indigo-300 bg-clip-text text-transparent">
32
+ Welcome to NexusFlow
33
+ </h1>
34
+ <p className="text-sm text-gray-400 mb-8 max-w-xl">
35
+ NexusFlow orchestrates multi-repository developer environments. It combines isolated Git worktrees, automatic code analyzer sweeps, and background process running into a single dashboard.
36
+ </p>
37
+
38
+ {/* Onboarding Steps */}
39
+ <div className="space-y-6">
40
+ <div className="flex gap-4">
41
+ <div className="w-8 h-8 rounded-full bg-indigo-500/10 border border-indigo-500/20 text-indigo-400 flex items-center justify-center font-bold text-sm shrink-0">
42
+ 1
43
+ </div>
44
+ <div>
45
+ <h3 className="text-sm font-semibold text-white">Configure Development Folders</h3>
46
+ <p className="text-xs text-gray-400 mt-1">
47
+ Specify your local code path and target workspaces path. For the first setup, these paths start empty so you can explicitly configure them.
48
+ </p>
49
+ </div>
50
+ </div>
51
+
52
+ <div className="flex gap-4">
53
+ <div className="w-8 h-8 rounded-full bg-indigo-500/10 border border-indigo-500/20 text-indigo-400 flex items-center justify-center font-bold text-sm shrink-0">
54
+ 2
55
+ </div>
56
+ <div>
57
+ <h3 className="text-sm font-semibold text-white">Build Isolated Branch Workspaces</h3>
58
+ <p className="text-xs text-gray-400 mt-1">
59
+ Choose repositories and input your feature branch. NexusFlow runs <code>git worktree</code> to checkout dependencies under a unified folder structure, leaving your primary repository directories clean.
60
+ </p>
61
+ </div>
62
+ </div>
63
+
64
+ <div className="flex gap-4">
65
+ <div className="w-8 h-8 rounded-full bg-indigo-500/10 border border-indigo-500/20 text-indigo-400 flex items-center justify-center font-bold text-sm shrink-0">
66
+ 3
67
+ </div>
68
+ <div>
69
+ <h3 className="text-sm font-semibold text-white">Align AI Coding Contexts</h3>
70
+ <p className="text-xs text-gray-400 mt-1">
71
+ NexusFlow automatically generates configuration files (<code>CLAUDE.md</code>, <code>.cursorrules</code>, <code>AGENTS.md</code>) that instruct the AI assistant to analyze project inter-dependencies, document its assumptions in <code>nexusflow-overview.md</code>, and highlight clarifying questions.
72
+ </p>
73
+ </div>
74
+ </div>
75
+
76
+ <div className="flex gap-4">
77
+ <div className="w-8 h-8 rounded-full bg-indigo-500/10 border border-indigo-500/20 text-indigo-400 flex items-center justify-center font-bold text-sm shrink-0">
78
+ 4
79
+ </div>
80
+ <div>
81
+ <h3 className="text-sm font-semibold text-white">Orchestrate Background Services</h3>
82
+ <p className="text-xs text-gray-400 mt-1">
83
+ Run APIs, database scripts, and frontend watch tasks concurrently from the web portal. Monitor real-time logs inside a unified terminal pane.
84
+ </p>
85
+ </div>
86
+ </div>
87
+ </div>
88
+ </div>
89
+
90
+ {/* Comparison Dashboard */}
91
+ <div className="mt-8 pt-6 border-t border-gray-800/80">
92
+ <h4 className="text-xs font-semibold uppercase tracking-wider text-gray-500 mb-3">Industry Comparison</h4>
93
+ <div className="overflow-x-auto font-sans">
94
+ <table className="w-full text-[10px] text-gray-400 text-left border-collapse">
95
+ <thead>
96
+ <tr className="border-b border-gray-800 text-gray-500">
97
+ <th className="py-2 pr-4 font-semibold">Orchestrator</th>
98
+ <th className="py-2 px-4 font-semibold">Multi-Repo</th>
99
+ <th className="py-2 px-4 font-semibold">AI Rules Integration</th>
100
+ <th className="py-2 pl-4 font-semibold">Weight</th>
101
+ </tr>
102
+ </thead>
103
+ <tbody>
104
+ <tr className="border-b border-gray-800/40">
105
+ <td className="py-2 pr-4 font-semibold text-white">Docker Compose</td>
106
+ <td className="py-2 px-4">Yes (Containers only)</td>
107
+ <td className="py-2 px-4">No</td>
108
+ <td className="py-2 pl-4">Medium (VM overhead)</td>
109
+ </tr>
110
+ <tr className="border-b border-gray-800/40">
111
+ <td className="py-2 pr-4 font-semibold text-white">Lerna / Turborepo</td>
112
+ <td className="py-2 px-4">Monorepo only</td>
113
+ <td className="py-2 px-4">No</td>
114
+ <td className="py-2 pl-4">Light</td>
115
+ </tr>
116
+ <tr className="border-b border-gray-800/40">
117
+ <td className="py-2 pr-4 font-semibold text-white">DevPod / Gitpod</td>
118
+ <td className="py-2 px-4">Yes (Complex config)</td>
119
+ <td className="py-2 px-4">No</td>
120
+ <td className="py-2 pl-4">Heavy (Full virtual VM)</td>
121
+ </tr>
122
+ <tr>
123
+ <td className="py-2 pr-4 font-semibold text-indigo-400">NexusFlow</td>
124
+ <td className="py-2 px-4 text-indigo-300">Yes (Native Worktrees)</td>
125
+ <td className="py-2 px-4 text-indigo-300">Yes (CLAUDE.md/MDC rules)</td>
126
+ <td className="py-2 pl-4 text-indigo-300">Extremely Light (Native processes)</td>
127
+ </tr>
128
+ </tbody>
129
+ </table>
130
+ </div>
131
+ </div>
132
+ </div>
133
+
134
+ {/* Right Column: Configuration Form */}
135
+ <div className="lg:col-span-5 flex flex-col justify-center">
136
+ <div className="bg-gray-950/40 border border-gray-800/80 rounded-2xl p-6 shadow-lg">
137
+ <h2 className="text-xl font-bold text-white mb-1 flex items-center gap-2">
138
+ <SettingsIcon className="text-indigo-400 animate-spin-slow" size={20} /> Initialize Config
139
+ </h2>
140
+ <p className="text-xs text-gray-500 mb-6">
141
+ Define the directories on your machine. The fields are empty so you can provide your paths.
142
+ </p>
143
+
144
+ {/* Form Input fields */}
145
+ <div className="space-y-5">
146
+ <div>
147
+ <label className="block text-[11px] font-semibold text-gray-400 uppercase tracking-wider mb-2">Development Directory</label>
148
+ <input
149
+ type="text"
150
+ className="w-full bg-[#111827] border border-gray-800 focus:border-indigo-500 focus:ring-1 focus:ring-indigo-500 rounded-lg px-4 py-3 text-white placeholder-gray-600 transition-all outline-none text-xs shadow-inner"
151
+ placeholder="e.g. C:\Users\username\dev"
152
+ value={config.devDir}
153
+ onChange={(e) => setConfig({ ...config, devDir: e.target.value })}
154
+ />
155
+ {defaultPaths && (
156
+ <div className="text-[10px] text-gray-500 mt-1.5 flex justify-between items-center">
157
+ <span>Suggested: <code>{defaultPaths.devDir}</code></span>
158
+ </div>
159
+ )}
160
+ </div>
161
+
162
+ <div>
163
+ <label className="block text-[11px] font-semibold text-gray-400 uppercase tracking-wider mb-2">Workspaces Directory</label>
164
+ <input
165
+ type="text"
166
+ className="w-full bg-[#111827] border border-gray-800 focus:border-indigo-500 focus:ring-1 focus:ring-indigo-500 rounded-lg px-4 py-3 text-white placeholder-gray-600 transition-all outline-none text-xs shadow-inner"
167
+ placeholder="e.g. C:\Users\username\dev\workspaces"
168
+ value={config.workspacesDir}
169
+ onChange={(e) => setConfig({ ...config, workspacesDir: e.target.value })}
170
+ />
171
+ {defaultPaths && (
172
+ <div className="text-[10px] text-gray-500 mt-1.5 flex justify-between items-center">
173
+ <span>Suggested: <code>{defaultPaths.workspacesDir}</code></span>
174
+ </div>
175
+ )}
176
+ </div>
177
+
178
+ {/* Form Buttons */}
179
+ <div className="flex gap-2 pt-2">
180
+ <button
181
+ type="button"
182
+ className="flex-1 inline-flex items-center justify-center gap-1.5 px-3 py-2 bg-gray-900 border border-gray-800 hover:bg-gray-800 hover:border-gray-700 rounded-lg text-xs font-semibold transition-all cursor-pointer"
183
+ onClick={() => {
184
+ if (defaultPaths) {
185
+ setConfig({
186
+ ...config,
187
+ devDir: defaultPaths.devDir,
188
+ workspacesDir: defaultPaths.workspacesDir,
189
+ });
190
+ }
191
+ }}
192
+ >
193
+ Suggest Defaults
194
+ </button>
195
+ <button
196
+ type="button"
197
+ className="px-3 py-2 bg-gray-900 border border-gray-800 hover:bg-gray-800 hover:border-rose-900/60 hover:text-rose-400 rounded-lg text-xs font-semibold transition-all cursor-pointer"
198
+ onClick={() => {
199
+ setConfig({
200
+ ...config,
201
+ devDir: '',
202
+ workspacesDir: '',
203
+ version: config.version,
204
+ defaultAssistant: config.defaultAssistant,
205
+ scanDepth: config.scanDepth,
206
+ });
207
+ }}
208
+ >
209
+ Clear
210
+ </button>
211
+ </div>
212
+
213
+ {/* Save Button */}
214
+ <div className="pt-4">
215
+ <button
216
+ type="button"
217
+ className="w-full inline-flex items-center justify-center gap-2 px-5 py-3 rounded-lg text-sm font-semibold bg-gradient-to-r from-indigo-500 to-indigo-600 hover:from-indigo-600 hover:to-indigo-700 text-white shadow-lg shadow-indigo-500/20 hover:-translate-y-0.5 active:translate-y-0 disabled:opacity-40 disabled:cursor-not-allowed disabled:hover:translate-y-0 transition-all cursor-pointer"
218
+ disabled={!isFormValid}
219
+ onClick={() => saveAppConfig(config)}
220
+ >
221
+ Save & Get Started <ArrowRight size={16} />
222
+ </button>
223
+ </div>
224
+ </div>
225
+ </div>
226
+ </div>
227
+ </div>
228
+ </div>
229
+ );
230
+ };