Files
fusion/packages/dashboard/app/components/SetupWizardModal.css
gsxdsm 91737b1831 FN-7433: add explicit onboarding git setup modes
Expose explicit git setup choices in first-run onboarding and project registration.

- Add setup wizard modes for existing repositories, new git initialization, and remote cloning with mode-specific hints and validation.
- Extend project registration to accept gitSetupMode while preserving legacy cloneUrl-only behavior.
- Cover init and clone validation paths with dashboard tests, localized copy, docs, and a published package changeset.

Files changed:
 .changeset/fn-7433-onboarding-git-setup.md         |   7 +
 docs/dashboard-guide.md                            |  10 ++
 docs/getting-started.md                            |  10 +-
 packages/dashboard/app/api/legacy.ts               |   1 +
 .../dashboard/app/components/SetupWizardModal.css  |  77 +++++++++-
 .../dashboard/app/components/SetupWizardModal.tsx  | 159 ++++++++++++++-------
 .../components/__tests__/SetupWizardModal.test.tsx | 107 +++++++++++++-
 .../dashboard/src/__tests__/project-routes.test.ts |  98 +++++++++++++
 .../src/routes/register-project-routes.ts          |  25 +++-
 packages/i18n/locales/en/app.json                  |  23 ++-
 packages/i18n/locales/es/app.json                  |  25 +++-
 packages/i18n/locales/fr/app.json                  |  25 +++-
 packages/i18n/locales/ko/app.json                  |  25 +++-
 packages/i18n/locales/zh-CN/app.json               |  25 +++-
 packages/i18n/locales/zh-TW/app.json               |  25 +++-
 15 files changed, 538 insertions(+), 104 deletions(-)

Fusion-Task-Id: FN-7433

Fusion-Task-Lineage: 022c25c2-3c2d-4e47-aa8c-02525caad672

Co-authored-by: Fusion (runfusion.ai) <noreply@runfusion.ai>
2026-07-02 11:38:34 -07:00

773 lines
16 KiB
CSS

/* === Wizard Shared Styles (used by SetupWizardModal) === */
.wizard-option-recommended {
display: inline-flex;
align-items: center;
width: fit-content;
padding: calc(var(--space-xs) / 2) var(--space-sm);
background: color-mix(in srgb, var(--color-success) 10%, transparent);
color: var(--color-success) !important;
border-radius: var(--radius-sm);
font-size: calc(var(--space-md) - (var(--space-xs) / 4)) !important;
font-weight: 600;
text-transform: uppercase;
letter-spacing: 0.5px;
}
.wizard-error {
display: flex;
align-items: center;
gap: var(--space-sm);
padding: var(--space-md);
background: color-mix(in srgb, var(--color-error) 10%, transparent);
border: 1px solid color-mix(in srgb, var(--color-error) 35%, transparent);
border-radius: var(--radius-md);
color: var(--color-error);
font-size: calc(var(--space-md) + (var(--space-xs) / 4));
}
/* === Setup Wizard Modal (Onboarding) === */
.setup-wizard-overlay {
overflow-y: auto;
overscroll-behavior: contain;
}
.modal.setup-wizard-modal {
display: flex;
flex-direction: column;
max-width: 880px;
width: 90vw;
/* vh fallback first for browsers without dvh support; dvh upgrade follows. */
max-height: min(720px, calc(100vh - var(--overlay-padding-top, 10vh) - var(--space-lg)));
max-height: min(720px, calc(100dvh - var(--overlay-padding-top, 10vh) - var(--space-lg)));
animation: slideUp var(--duration-normal) ease-out;
overflow: hidden;
/* Prevent flex parents from squeezing this below its content's needs. */
flex-shrink: 0;
}
.modal.setup-wizard-modal--agent {
max-width: 1120px;
width: min(96vw, 1120px);
}
@keyframes slideUp {
from {
opacity: 0;
transform: translateY(16px);
}
to {
opacity: 1;
transform: translateY(0);
}
}
.setup-wizard-header {
display: flex;
align-items: center;
justify-content: space-between;
padding: var(--space-xl) var(--space-xl) 0;
gap: var(--space-md);
flex-shrink: 0;
}
.setup-wizard-heading {
display: flex;
flex-direction: column;
gap: var(--space-xs);
flex: 1 1 auto;
min-width: 0;
}
.setup-wizard-brand {
display: inline-flex;
align-items: center;
gap: var(--space-sm);
color: var(--logo-accent);
}
.setup-wizard-brand-logo {
width: 28px;
height: 28px;
flex-shrink: 0;
}
.setup-wizard-brand-name {
font-size: 22px;
font-weight: 800;
letter-spacing: -0.02em;
line-height: 1;
}
.setup-wizard-title {
font-size: 24px;
font-weight: 800;
color: var(--text);
margin: 0;
line-height: 1.1;
}
.setup-wizard-content {
padding: var(--space-md) var(--space-xl);
flex: 1 1 auto;
min-height: 0;
overflow-y: auto;
}
.setup-wizard-manual {
display: flex;
flex-direction: column;
}
.setup-wizard-manual .welcome-icon {
display: flex;
align-items: center;
justify-content: center;
width: 64px;
height: 64px;
background: color-mix(in srgb, var(--todo) 10%, transparent);
border-radius: var(--radius-lg);
color: var(--todo);
margin-bottom: var(--space-lg);
}
.setup-wizard-manual .welcome-text {
font-size: 14px;
color: var(--text-muted);
line-height: 1.6;
margin: 0 0 var(--space-xl);
}
.setup-wizard-repository-section {
display: flex;
flex-direction: column;
gap: var(--space-sm);
margin-bottom: var(--space-lg);
padding: var(--space-md);
border: 1px solid var(--border);
border-radius: var(--radius-lg);
background: var(--card);
}
.setup-wizard-section-heading {
display: flex;
flex-direction: column;
gap: calc(var(--space-xs) / 2);
}
.setup-wizard-section-heading h3,
.setup-wizard-section-heading p {
margin: 0;
}
.setup-wizard-section-heading h3 {
color: var(--text);
font-size: var(--font-size-md);
font-weight: 700;
}
.setup-wizard-section-heading p {
color: var(--text-muted);
font-size: var(--font-size-sm);
line-height: 1.45;
}
.setup-wizard-mode-switch {
display: grid;
grid-template-columns: repeat(3, minmax(0, 1fr));
gap: var(--space-sm);
margin: 0;
padding: 0;
border: 0;
}
.setup-wizard-mode-switch legend {
font-size: var(--font-size-sm);
font-weight: 600;
color: var(--text);
margin-bottom: var(--space-xs);
}
.setup-wizard-mode-option {
display: flex;
align-items: flex-start;
gap: var(--space-sm);
padding: var(--space-sm) var(--space-md);
border: 1px solid var(--border);
border-radius: var(--radius-md);
background: var(--surface);
color: var(--text);
cursor: pointer;
transition:
border-color var(--transition-fast),
background-color var(--transition-fast),
box-shadow var(--transition-fast);
}
.setup-wizard-mode-option input {
flex: 0 0 auto;
margin-top: calc(var(--space-xs) / 2);
accent-color: var(--todo);
}
.setup-wizard-mode-option-copy {
display: flex;
flex-direction: column;
gap: calc(var(--space-xs) / 2);
min-width: 0;
}
.setup-wizard-mode-option-copy strong {
color: var(--text);
font-size: var(--font-size-sm);
line-height: 1.3;
}
.setup-wizard-mode-option-copy span {
color: var(--text-muted);
font-size: var(--font-size-xs);
line-height: 1.35;
}
.setup-wizard-mode-option:hover {
border-color: var(--text-dim);
}
.setup-wizard-mode-option.selected {
border-color: var(--todo);
background: color-mix(in srgb, var(--todo) 10%, transparent);
box-shadow: 0 0 0 1px color-mix(in srgb, var(--todo) 25%, transparent);
}
.setup-wizard-manual .form-group {
margin-bottom: var(--space-lg);
}
.setup-wizard-manual .form-group label {
display: block;
font-size: 13px;
font-weight: 600;
color: var(--text);
margin-bottom: var(--space-xs);
}
.setup-wizard-manual .form-group input,
.setup-wizard-manual .form-group select {
width: 100%;
padding: 10px 12px;
background: var(--surface);
border: 1px solid var(--border);
border-radius: var(--radius-md);
color: var(--text);
font-size: 14px;
transition: border-color var(--transition-fast), box-shadow var(--transition-fast);
}
.setup-wizard-manual .form-group input:focus,
.setup-wizard-manual .form-group select:focus {
outline: none;
border-color: var(--todo);
box-shadow: var(--focus-ring);
}
.setup-wizard-manual .form-hint {
margin: 4px 0 0;
font-size: 12px;
color: var(--text-dim);
}
.setup-wizard-isolation-options {
display: flex;
flex-direction: column;
gap: var(--space-sm);
}
.setup-wizard-advanced {
margin-top: var(--space-sm);
border-top: 1px solid var(--border);
padding-top: var(--space-lg);
}
.setup-wizard-advanced-toggle {
width: 100%;
display: flex;
align-items: center;
gap: var(--space-sm);
padding: var(--space-sm) 0;
background: transparent;
border: none;
color: var(--text);
font-size: 14px;
font-weight: 600;
text-align: left;
cursor: pointer;
}
.setup-wizard-advanced-toggle:hover {
color: var(--logo-accent);
}
.setup-wizard-advanced-toggle:focus-visible {
outline: none;
box-shadow: var(--focus-ring-strong);
border-radius: var(--radius-sm);
}
.setup-wizard-advanced-toggle[aria-expanded="true"] .setup-wizard-advanced-chevron {
transform: rotate(90deg);
}
.setup-wizard-advanced-chevron {
flex-shrink: 0;
transition: transform var(--transition-fast);
}
.setup-wizard-advanced-panel {
display: flex;
flex-direction: column;
gap: var(--space-sm);
margin-top: var(--space-sm);
padding: var(--space-md);
background: var(--card);
border: 1px solid var(--border);
border-radius: var(--radius-lg);
}
.setup-wizard-advanced-panel .form-group:last-child {
margin-bottom: 0;
}
.setup-wizard-inline-spinner {
display: inline-block;
margin-right: var(--space-xs);
vertical-align: middle;
}
.setup-wizard-auth-token {
display: flex;
flex-direction: column;
gap: var(--space-sm);
}
.setup-wizard-auth-token-actions {
display: flex;
flex-wrap: wrap;
gap: var(--space-sm);
}
.setup-wizard-auth-token-actions .btn {
min-height: 36px;
}
.setup-wizard-auth-step {
display: flex;
flex-direction: column;
gap: var(--space-lg);
}
.setup-wizard-auth-step-description {
font-size: 14px;
color: var(--text-muted);
line-height: 1.6;
margin: 0;
}
.setup-wizard-auth-step code {
font-family: var(--font-mono);
font-size: 12px;
padding: 2px 6px;
background: var(--card);
border: 1px solid var(--border);
border-radius: var(--radius-sm);
}
.setup-wizard-agent-step {
display: flex;
flex-direction: column;
gap: var(--space-lg);
}
.setup-wizard-agent-intro {
margin: 0;
color: var(--text-muted);
font-size: 14px;
line-height: 1.55;
}
.setup-wizard-agent-layout {
display: grid;
grid-template-columns: minmax(360px, 1.08fr) minmax(320px, 0.92fr);
gap: var(--space-lg);
align-items: start;
}
.setup-wizard-agent-section-heading {
margin-bottom: var(--space-sm);
color: var(--text);
font-size: 13px;
font-weight: 700;
text-transform: uppercase;
letter-spacing: 0.04em;
}
.setup-wizard-agent-preset-list {
display: grid;
gap: var(--space-sm);
max-height: min(360px, 48dvh);
overflow-y: auto;
padding-right: var(--space-xs);
}
.setup-wizard-agent-preset {
display: grid;
grid-template-columns: auto minmax(0, 1fr);
gap: var(--space-sm);
width: 100%;
padding: var(--space-sm) var(--space-md);
border: 1px solid var(--border);
border-radius: var(--radius-md);
background: var(--surface);
color: var(--text);
text-align: left;
cursor: pointer;
transition:
background-color var(--transition-fast),
border-color var(--transition-fast),
box-shadow var(--transition-fast);
}
.setup-wizard-agent-preset:hover {
background: var(--card-hover);
border-color: var(--text-dim);
}
.setup-wizard-agent-preset:focus-visible {
outline: none;
border-color: var(--todo);
box-shadow: var(--focus-ring-strong);
}
.setup-wizard-agent-preset.selected {
background: color-mix(in srgb, var(--todo) 8%, transparent);
border-color: var(--todo);
box-shadow: 0 0 0 1px color-mix(in srgb, var(--todo) 25%, transparent);
}
.setup-wizard-agent-preset:disabled {
cursor: not-allowed;
opacity: 0.65;
}
.setup-wizard-agent-preset-copy {
display: flex;
flex-direction: column;
gap: calc(var(--space-xs) / 2);
min-width: 0;
}
.setup-wizard-agent-preset-name {
display: flex;
align-items: center;
gap: var(--space-sm);
font-size: 14px;
font-weight: 700;
}
.setup-wizard-agent-preset-description {
color: var(--text-muted);
font-size: 12px;
line-height: 1.35;
}
.setup-wizard-agent-preview-card {
display: flex;
flex-direction: column;
gap: var(--space-md);
padding: var(--space-md);
border: 1px solid var(--border);
border-radius: var(--radius-lg);
background: var(--card);
}
.setup-wizard-agent-preview-title-row {
display: grid;
grid-template-columns: auto minmax(0, 1fr);
gap: var(--space-sm);
align-items: center;
}
.setup-wizard-agent-preview-title-row h3,
.setup-wizard-agent-preview-title-row p {
margin: 0;
}
.setup-wizard-agent-preview-title-row h3 {
color: var(--text);
font-size: 18px;
font-weight: 800;
}
.setup-wizard-agent-preview-title-row p {
color: var(--text-muted);
font-size: 13px;
line-height: 1.4;
}
.setup-wizard-agent-preview-list {
display: grid;
gap: var(--space-sm);
margin: 0;
}
.setup-wizard-agent-preview-list div {
display: grid;
gap: calc(var(--space-xs) / 2);
}
.setup-wizard-agent-preview-list dt {
color: var(--text-dim);
font-size: 12px;
font-weight: 700;
text-transform: uppercase;
letter-spacing: 0.04em;
}
.setup-wizard-agent-preview-list dd {
margin: 0;
color: var(--text);
font-size: 13px;
line-height: 1.45;
max-height: 96px;
overflow-y: auto;
}
.setup-wizard-agent-ai-btn {
display: inline-flex;
align-items: center;
justify-content: center;
gap: var(--space-sm);
width: 100%;
min-height: 40px;
}
.setup-wizard-agent-interview-error {
position: fixed;
left: 50%;
bottom: var(--space-xl);
z-index: 1000;
width: min(520px, calc(100vw - (var(--space-lg) * 2)));
transform: translateX(-50%);
align-items: flex-start;
flex-direction: column;
}
.setup-wizard-isolation-option {
display: flex;
align-items: flex-start;
gap: var(--space-md);
padding: var(--space-md) var(--space-lg);
background: var(--card);
border: 1px solid var(--border);
border-radius: var(--radius-lg);
cursor: pointer;
transition:
background-color var(--transition-fast),
border-color var(--transition-fast);
}
.setup-wizard-isolation-option:hover {
background: var(--card-hover);
border-color: var(--text-dim);
}
.setup-wizard-isolation-option.selected {
background: color-mix(in srgb, var(--todo) 5%, transparent);
border-color: var(--todo);
box-shadow: 0 0 0 1px var(--todo);
}
.setup-wizard-isolation-option input[type="radio"] {
margin-top: 2px;
accent-color: var(--todo);
}
.setup-wizard-isolation-option-content {
display: flex;
flex-direction: column;
gap: 2px;
}
.setup-wizard-isolation-option-content strong {
font-size: 14px;
font-weight: 600;
color: var(--text);
}
.setup-wizard-isolation-option-content span {
font-size: 12px;
color: var(--text-muted);
}
.setup-wizard-isolation-option .wizard-option-recommended {
margin-top: 2px;
}
.setup-wizard-complete {
display: flex;
flex-direction: column;
align-items: center;
text-align: center;
gap: var(--space-sm);
padding: var(--space-lg) 0;
}
.setup-wizard-complete .success-icon {
color: var(--color-success);
}
.setup-wizard-complete h3 {
font-size: 20px;
font-weight: 700;
color: var(--text);
margin: 0;
}
.setup-wizard-complete p {
font-size: 14px;
color: var(--text-muted);
margin: 0;
line-height: 1.5;
}
.setup-wizard-footer {
display: flex;
align-items: center;
gap: var(--space-sm);
justify-content: flex-end;
padding: var(--space-md) var(--space-xl) var(--space-lg);
flex-shrink: 0;
border-top: 1px solid var(--border);
background: var(--surface);
}
.setup-wizard-footer .btn-primary {
display: inline-flex;
align-items: center;
gap: var(--space-sm);
padding: 10px 24px;
font-size: 14px;
font-weight: 600;
}
.setup-wizard-help-link {
margin-right: auto;
text-decoration: none;
}
.setup-wizard-footer .btn-primary:disabled {
opacity: 0.5;
cursor: not-allowed;
}
@media (max-width: 768px) {
.setup-wizard-overlay {
padding:
max(var(--space-md), env(safe-area-inset-top, 0px))
max(var(--space-md), env(safe-area-inset-right, 0px))
max(var(--space-md), env(safe-area-inset-bottom, 0px))
max(var(--space-md), env(safe-area-inset-left, 0px));
}
.setup-wizard-modal {
display: flex;
flex-direction: column;
max-width: 100%;
width: 100%;
max-height: calc(100vh - max(var(--space-2xl), env(safe-area-inset-top, 0px)) - max(var(--space-2xl), env(safe-area-inset-bottom, 0px)));
max-height: calc(100dvh - max(var(--space-2xl), env(safe-area-inset-top, 0px)) - max(var(--space-2xl), env(safe-area-inset-bottom, 0px)));
border-radius: var(--radius-lg);
}
.setup-wizard-header {
padding: var(--space-md) var(--space-md) 0;
}
.setup-wizard-brand-name {
font-size: 20px;
}
.setup-wizard-title {
font-size: 21px;
}
.setup-wizard-content {
padding: var(--space-md);
}
.setup-wizard-mode-switch {
grid-template-columns: 1fr;
}
.setup-wizard-isolation-options {
gap: var(--space-xs);
}
.setup-wizard-mode-switch {
grid-template-columns: 1fr;
}
.setup-wizard-repository-section {
padding: var(--space-sm);
}
.setup-wizard-agent-layout {
grid-template-columns: 1fr;
}
.setup-wizard-agent-preset-list {
max-height: none;
overflow-y: visible;
padding-right: 0;
}
.setup-wizard-isolation-option {
padding: var(--space-sm) var(--space-md);
}
.setup-wizard-advanced-panel {
padding: var(--space-sm);
}
.setup-wizard-auth-token-actions .btn {
width: 100%;
justify-content: center;
}
.setup-wizard-footer {
flex-direction: column;
align-items: stretch;
padding:
var(--space-sm)
var(--space-md)
max(var(--space-md), env(safe-area-inset-bottom, 0px));
}
.setup-wizard-footer .btn-primary {
width: 100%;
justify-content: center;
}
.setup-wizard-help-link {
margin-right: 0;
width: 100%;
justify-content: center;
}
.setup-wizard-complete {
padding: var(--space-lg) 0;
}
}
/* =========================================================================
Agent Manager UI — Global CSS Classes
========================================================================= */