@mrpatronz/nexusflow 0.2.13 → 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 (186) 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/desktop.d.ts +12 -0
  15. package/dist/commands/desktop.d.ts.map +1 -0
  16. package/dist/commands/desktop.js +119 -0
  17. package/dist/commands/desktop.js.map +1 -0
  18. package/dist/commands/sync.d.ts.map +1 -1
  19. package/dist/commands/sync.js +1 -3
  20. package/dist/commands/sync.js.map +1 -1
  21. package/dist/commands/tui.d.ts +8 -0
  22. package/dist/commands/tui.d.ts.map +1 -0
  23. package/dist/commands/tui.js +386 -0
  24. package/dist/commands/tui.js.map +1 -0
  25. package/dist/commands/ui.d.ts +3 -1
  26. package/dist/commands/ui.d.ts.map +1 -1
  27. package/dist/commands/ui.js +76 -19
  28. package/dist/commands/ui.js.map +1 -1
  29. package/dist/generators/base.d.ts.map +1 -1
  30. package/dist/generators/base.js +78 -66
  31. package/dist/generators/base.js.map +1 -1
  32. package/dist/generators/codex.js +11 -11
  33. package/dist/generators/copilot.js +17 -17
  34. package/dist/generators/cursor.js +5 -5
  35. package/dist/generators/index.js +50 -50
  36. package/dist/generators/map-generator.js +14 -14
  37. package/dist/generators/skills-generator.js +28 -28
  38. package/dist/gui/app_logo.png +0 -0
  39. package/dist/gui/assets/index-Ct3qq-X4.js +25 -0
  40. package/dist/gui/assets/index-P_ZrgHXg.css +1 -0
  41. package/dist/gui/icons.svg +24 -24
  42. package/dist/gui/index.html +18 -18
  43. package/dist/index.js +43 -0
  44. package/dist/index.js.map +1 -1
  45. package/dist/server.d.ts.map +1 -1
  46. package/dist/server.js +182 -1
  47. package/dist/server.js.map +1 -1
  48. package/dist/server.test.js +78 -0
  49. package/dist/server.test.js.map +1 -1
  50. package/dist/types.d.ts +4 -0
  51. package/dist/types.d.ts.map +1 -1
  52. package/dist/utils/git.d.ts +16 -0
  53. package/dist/utils/git.d.ts.map +1 -1
  54. package/dist/utils/git.js +52 -0
  55. package/dist/utils/git.js.map +1 -1
  56. package/dist/utils/multi-git.d.ts +2 -0
  57. package/dist/utils/multi-git.d.ts.map +1 -1
  58. package/dist/utils/multi-git.js +5 -2
  59. package/dist/utils/multi-git.js.map +1 -1
  60. package/dist/utils/update-check.d.ts +3 -1
  61. package/dist/utils/update-check.d.ts.map +1 -1
  62. package/dist/utils/update-check.js +23 -6
  63. package/dist/utils/update-check.js.map +1 -1
  64. package/dist/utils/workflows.d.ts +11 -0
  65. package/dist/utils/workflows.d.ts.map +1 -0
  66. package/dist/utils/workflows.js +156 -0
  67. package/dist/utils/workflows.js.map +1 -0
  68. package/dist/utils/workflows.test.d.ts +2 -0
  69. package/dist/utils/workflows.test.d.ts.map +1 -0
  70. package/dist/utils/workflows.test.js +86 -0
  71. package/dist/utils/workflows.test.js.map +1 -0
  72. package/extension/media/icon.svg +1 -0
  73. package/extension/package-lock.json +2673 -2811
  74. package/extension/package.json +108 -70
  75. package/extension/src/extension.ts +631 -204
  76. package/extension/tsconfig.json +21 -19
  77. package/gui/README.md +73 -73
  78. package/gui/e2e/wizard.spec.ts +346 -327
  79. package/gui/eslint.config.js +26 -26
  80. package/gui/index.html +17 -17
  81. package/gui/package-lock.json +3079 -3118
  82. package/gui/package.json +36 -36
  83. package/gui/playwright.config.ts +41 -41
  84. package/gui/public/app_logo.png +0 -0
  85. package/gui/public/icons.svg +24 -24
  86. package/gui/src/App.css +1 -1
  87. package/gui/src/App.tsx +3407 -2722
  88. package/gui/src/assets/vite.svg +1 -1
  89. package/gui/src/features/changes/ChangesViewer.tsx +388 -388
  90. package/gui/src/features/knowledge/KnowledgeBase.tsx +84 -84
  91. package/gui/src/features/onboarding/OnboardingWizard.tsx +230 -230
  92. package/gui/src/features/plan/ImplementationPlan.tsx +32 -32
  93. package/gui/src/features/services/ServiceConsole.tsx +250 -250
  94. package/gui/src/features/sessions/SessionHistory.tsx +195 -195
  95. package/gui/src/features/workspace/WorkspaceList.tsx +666 -666
  96. package/gui/src/index.css +152 -110
  97. package/gui/src/main.tsx +94 -10
  98. package/gui/src/types.ts +62 -62
  99. package/gui/tsconfig.app.json +25 -25
  100. package/gui/tsconfig.json +7 -7
  101. package/gui/tsconfig.node.json +24 -24
  102. package/gui/vite.config.ts +12 -12
  103. package/package.json +56 -56
  104. package/resources/workflows/plan-implement-review.md +8 -0
  105. package/resources/workflows/research-verify.md +6 -0
  106. package/resources/workflows/solo-developer.md +3 -0
  107. package/scripts/simulate-workspaces.ts +55 -55
  108. package/src/analyzers/detect-apis.ts +290 -290
  109. package/src/analyzers/detect-deps.ts +315 -315
  110. package/src/analyzers/detect-existing.ts +74 -74
  111. package/src/analyzers/detect-ports.ts +110 -110
  112. package/src/analyzers/index.ts +97 -97
  113. package/src/analyzers/messaging-analyzer.ts +254 -254
  114. package/src/analyzers/readme-summarizer.ts +102 -102
  115. package/src/analyzers/run-analyzer.ts +269 -269
  116. package/src/analyzers/tech-stack.ts +283 -283
  117. package/src/commands/add-repo.ts +157 -157
  118. package/src/commands/commands.test.ts +155 -155
  119. package/src/commands/commit.ts +131 -131
  120. package/src/commands/create.ts +207 -207
  121. package/src/commands/desktop.ts +128 -0
  122. package/src/commands/diff.ts +125 -125
  123. package/src/commands/doctor.ts +357 -357
  124. package/src/commands/handoff.ts +266 -266
  125. package/src/commands/init.ts +134 -134
  126. package/src/commands/list.ts +46 -46
  127. package/src/commands/logs.ts +63 -63
  128. package/src/commands/mcp.ts +92 -92
  129. package/src/commands/open.ts +129 -129
  130. package/src/commands/pack.ts +73 -73
  131. package/src/commands/refresh.ts +147 -147
  132. package/src/commands/remove.ts +98 -98
  133. package/src/commands/start.ts +117 -117
  134. package/src/commands/status.ts +54 -54
  135. package/src/commands/stop.ts +55 -55
  136. package/src/commands/sync.ts +151 -153
  137. package/src/commands/tui.ts +424 -0
  138. package/src/commands/ui.ts +111 -47
  139. package/src/core/config.test.ts +96 -96
  140. package/src/core/config.ts +115 -115
  141. package/src/core/graph.ts +344 -344
  142. package/src/core/packer.test.ts +99 -99
  143. package/src/core/packer.ts +107 -107
  144. package/src/core/scanner.test.ts +61 -61
  145. package/src/core/scanner.ts +91 -91
  146. package/src/core/workspace.ts +380 -380
  147. package/src/core/worktree.ts +120 -120
  148. package/src/generators/antigravity.ts +32 -32
  149. package/src/generators/base.ts +240 -227
  150. package/src/generators/claude.ts +34 -34
  151. package/src/generators/codex.ts +48 -48
  152. package/src/generators/copilot.ts +56 -56
  153. package/src/generators/cursor.ts +44 -44
  154. package/src/generators/index.ts +250 -250
  155. package/src/generators/map-generator.test.ts +159 -159
  156. package/src/generators/map-generator.ts +542 -542
  157. package/src/generators/plan-generator.ts +481 -481
  158. package/src/generators/skills-generator.ts +259 -259
  159. package/src/index.ts +426 -382
  160. package/src/mcp/server.ts +294 -294
  161. package/src/orchestration/detect.ts +313 -313
  162. package/src/orchestration/index.ts +7 -7
  163. package/src/orchestration/runner.ts +283 -283
  164. package/src/server.test.ts +555 -464
  165. package/src/server.ts +1308 -1104
  166. package/src/types.ts +408 -403
  167. package/src/utils/detect-ai.test.ts +44 -44
  168. package/src/utils/detect-ai.ts +84 -84
  169. package/src/utils/detect-editors.test.ts +48 -48
  170. package/src/utils/detect-editors.ts +57 -57
  171. package/src/utils/git.test.ts +74 -74
  172. package/src/utils/git.ts +117 -61
  173. package/src/utils/local-ai.test.ts +130 -130
  174. package/src/utils/local-ai.ts +111 -111
  175. package/src/utils/multi-git.ts +313 -306
  176. package/src/utils/prompts.ts +209 -209
  177. package/src/utils/session-finder.ts +483 -483
  178. package/src/utils/system-scanner.test.ts +89 -89
  179. package/src/utils/system-scanner.ts +96 -96
  180. package/src/utils/update-check.ts +309 -275
  181. package/src/utils/workflows.test.ts +114 -0
  182. package/src/utils/workflows.ts +178 -0
  183. package/tsconfig.json +19 -19
  184. package/vitest.config.ts +14 -14
  185. package/dist/gui/assets/index-CFWwqFux.js +0 -23
  186. package/dist/gui/assets/index-Dvc9QMvl.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
+ };