Files
create-better-t-stack/apps/web/src/app/(home)/_components/StackArchitech.tsx
2025-04-19 21:02:57 +05:30

1161 lines
37 KiB
TypeScript

"use client";
import {
DEFAULT_STACK,
PRESET_TEMPLATES,
type StackState,
TECH_OPTIONS,
} from "@/lib/constant";
import {
Check,
Circle,
CircleCheck,
ClipboardCopy,
HelpCircle,
InfoIcon,
RefreshCw,
Settings,
Star,
Terminal,
} from "lucide-react";
import { motion } from "motion/react";
import { useCallback, useEffect, useMemo, useRef, useState } from "react";
const validateProjectName = (name: string): string | undefined => {
const INVALID_CHARS = ["<", ">", ":", '"', "|", "?", "*"];
const MAX_LENGTH = 255;
if (name === ".") return undefined;
if (!name) return "Project name cannot be empty";
if (name.length > MAX_LENGTH) {
return `Project name must be less than ${MAX_LENGTH} characters`;
}
if (INVALID_CHARS.some((char) => name.includes(char))) {
return "Project name contains invalid characters";
}
if (name.startsWith(".") || name.startsWith("-")) {
return "Project name cannot start with a dot or dash";
}
if (
name.toLowerCase() === "node_modules" ||
name.toLowerCase() === "favicon.ico"
) {
return "Project name is reserved";
}
return undefined;
};
const CATEGORY_ORDER: Array<keyof typeof TECH_OPTIONS> = [
"frontend",
"runtime",
"backendFramework",
"api",
"database",
"orm",
"dbSetup",
"auth",
"packageManager",
"addons",
"examples",
"git",
"install",
];
const hasWebFrontend = (frontend: string[]) =>
frontend.some((f) =>
["tanstack-router", "react-router", "tanstack-start", "next"].includes(f),
);
const hasPWACompatibleFrontend = (frontend: string[]) =>
frontend.some((f) => ["tanstack-router", "react-router"].includes(f));
const hasNativeFrontend = (frontend: string[]) => frontend.includes("native");
const StackArchitect = () => {
const [stack, setStack] = useState<StackState>(DEFAULT_STACK);
const [command, setCommand] = useState("");
const [copied, setCopied] = useState(false);
const [compatNotes, setCompatNotes] = useState<
Record<string, { notes: string[]; hasIssue: boolean }>
>({});
const [projectNameError, setProjectNameError] = useState<string | undefined>(
undefined,
);
const [showPresets, setShowPresets] = useState(false);
const [showHelp, setShowHelp] = useState(false);
const [lastSavedStack, setLastSavedStack] = useState<StackState | null>(null);
const [activeCategory, setActiveCategory] = useState<string | null>(
CATEGORY_ORDER[0],
);
const sectionRefs = useRef<Record<string, HTMLElement | null>>({});
const contentRef = useRef<HTMLDivElement>(null);
const currentHasWebFrontend = useMemo(
() => hasWebFrontend(stack.frontend),
[stack.frontend],
);
const currentHasPWACompatibleFrontend = useMemo(
() => hasPWACompatibleFrontend(stack.frontend),
[stack.frontend],
);
const currentHasNativeFrontend = useMemo(
() => hasNativeFrontend(stack.frontend),
[stack.frontend],
);
useEffect(() => {
const savedStack = localStorage.getItem("betterTStackPreference");
if (savedStack) {
try {
const parsedStack = JSON.parse(savedStack) as StackState;
setLastSavedStack(parsedStack);
} catch (e) {
console.error("Failed to parse saved stack", e);
localStorage.removeItem("betterTStackPreference");
}
}
}, []);
// biome-ignore lint/correctness/useExhaustiveDependencies: Dependencies are logically required for validation inside updater
useEffect(() => {
setStack((currentStack) => {
const nextStack = { ...currentStack };
let changed = false;
const isWeb = hasWebFrontend(nextStack.frontend);
const isPWACompat = hasPWACompatibleFrontend(nextStack.frontend);
const isNative = hasNativeFrontend(nextStack.frontend);
if (nextStack.database === "none") {
if (nextStack.orm !== "none") {
nextStack.orm = "none";
changed = true;
}
if (nextStack.auth === "true") {
nextStack.auth = "false";
changed = true;
}
if (nextStack.dbSetup !== "none") {
nextStack.dbSetup = "none";
changed = true;
}
} else if (nextStack.database === "mongodb") {
if (nextStack.orm !== "prisma") {
nextStack.orm = "prisma";
changed = true;
}
}
if (nextStack.dbSetup === "turso") {
if (nextStack.database !== "sqlite") {
nextStack.database = "sqlite";
changed = true;
}
if (nextStack.orm !== "drizzle") {
nextStack.orm = "drizzle";
changed = true;
}
} else if (nextStack.dbSetup === "prisma-postgres") {
if (nextStack.database !== "postgres") {
nextStack.database = "postgres";
changed = true;
}
if (nextStack.orm !== "prisma") {
nextStack.orm = "prisma";
changed = true;
}
} else if (nextStack.dbSetup === "mongodb-atlas") {
if (nextStack.database !== "mongodb") {
nextStack.database = "mongodb";
changed = true;
}
if (nextStack.orm !== "prisma") {
nextStack.orm = "prisma";
changed = true;
}
} else if (nextStack.dbSetup === "neon") {
if (nextStack.database !== "postgres") {
nextStack.database = "postgres";
changed = true;
}
}
if (isNative && nextStack.api !== "trpc") {
nextStack.api = "trpc";
changed = true;
}
const incompatibleAddons: string[] = [];
if (!isPWACompat) {
incompatibleAddons.push("pwa", "tauri");
}
const originalAddonsLength = nextStack.addons.length;
nextStack.addons = nextStack.addons.filter(
(addon) => !incompatibleAddons.includes(addon),
);
if (nextStack.addons.length !== originalAddonsLength) {
changed = true;
}
if (
nextStack.addons.includes("husky") &&
!nextStack.addons.includes("biome")
) {
nextStack.addons.push("biome");
nextStack.addons = [...new Set(nextStack.addons)];
changed = true;
}
const incompatibleExamples: string[] = [];
if (!isWeb) {
incompatibleExamples.push("todo", "ai");
}
if (nextStack.database === "none") {
incompatibleExamples.push("todo");
}
if (nextStack.backendFramework === "elysia") {
incompatibleExamples.push("ai");
}
const originalExamplesLength = nextStack.examples.length;
nextStack.examples = nextStack.examples.filter(
(ex) => !incompatibleExamples.includes(ex),
);
if (nextStack.examples.length !== originalExamplesLength) {
changed = true;
}
return changed ? nextStack : currentStack;
});
}, [
stack.database,
stack.orm,
stack.auth,
stack.dbSetup,
stack.frontend,
stack.api,
stack.addons,
stack.examples,
stack.backendFramework,
]);
const generateCommand = useCallback((stackState: StackState) => {
let base: string;
switch (stackState.packageManager) {
case "npm":
base = "npx create-better-t-stack@latest";
break;
case "pnpm":
base = "pnpm create better-t-stack@latest";
break;
default:
base = "bun create better-t-stack@latest";
break;
}
const projectName = stackState.projectName || "my-better-t-app";
const flags: string[] = [];
const isDefault = <K extends keyof StackState>(
key: K,
value: StackState[K],
) => {
const defaultValue = DEFAULT_STACK[key];
if (Array.isArray(defaultValue) && Array.isArray(value)) {
return (
defaultValue.length === value.length &&
defaultValue.every((item) => value.includes(item)) &&
value.every((item) => defaultValue.includes(item))
);
}
return defaultValue === value;
};
if (!isDefault("frontend", stackState.frontend)) {
if (
stackState.frontend.length === 0 ||
stackState.frontend[0] === "none"
) {
flags.push("--frontend none");
} else {
flags.push(`--frontend ${stackState.frontend.join(" ")}`);
}
}
if (!isDefault("database", stackState.database)) {
flags.push(`--database ${stackState.database}`);
}
if (stackState.database !== "none" && !isDefault("orm", stackState.orm)) {
flags.push(`--orm ${stackState.orm}`);
}
if (!isDefault("auth", stackState.auth)) {
if (stackState.auth === "false") {
flags.push("--no-auth");
}
}
if (!isDefault("dbSetup", stackState.dbSetup)) {
flags.push(`--db-setup ${stackState.dbSetup}`);
}
if (!isDefault("backendFramework", stackState.backendFramework)) {
flags.push(`--backend ${stackState.backendFramework}`);
}
if (!isDefault("runtime", stackState.runtime)) {
flags.push(`--runtime ${stackState.runtime}`);
}
if (!isDefault("api", stackState.api)) {
flags.push(`--api ${stackState.api}`);
}
if (!isDefault("packageManager", stackState.packageManager)) {
flags.push(`--package-manager ${stackState.packageManager}`);
}
if (!isDefault("git", stackState.git)) {
if (stackState.git === "false") {
flags.push("--no-git");
}
}
if (!isDefault("install", stackState.install)) {
if (stackState.install === "false") {
flags.push("--no-install");
}
}
if (!isDefault("addons", stackState.addons)) {
if (stackState.addons.length > 0) {
flags.push(`--addons ${stackState.addons.join(" ")}`);
}
}
if (!isDefault("examples", stackState.examples)) {
if (stackState.examples.length > 0) {
flags.push(`--examples ${stackState.examples.join(" ")}`);
}
}
return `${base} ${projectName}${flags.length > 0 ? ` ${flags.join(" ")}` : ""}`;
}, []);
useEffect(() => {
const cmd = generateCommand(stack);
setCommand(cmd);
const notes: Record<string, { notes: string[]; hasIssue: boolean }> = {};
for (const cat of CATEGORY_ORDER) {
notes[cat] = { notes: [], hasIssue: false };
}
const isWeb = currentHasWebFrontend;
const isPWACompat = currentHasPWACompatibleFrontend;
const isNative = currentHasNativeFrontend;
if (isNative && stack.frontend.length > 1) {
notes.frontend.notes.push(
"React Native requires the tRPC API when used with other frontends. oRPC will be disabled.",
);
if (stack.api !== "trpc") notes.frontend.hasIssue = true;
}
if (
!isPWACompat &&
stack.addons.some((a) => ["pwa", "tauri"].includes(a))
) {
notes.frontend.notes.push(
"PWA/Tauri addons require TanStack or React Router.",
);
notes.frontend.hasIssue = true;
notes.addons.hasIssue = true;
}
if (!isWeb && stack.examples.length > 0) {
notes.frontend.notes.push("Examples require a web frontend.");
notes.frontend.hasIssue = true;
notes.examples.hasIssue = true;
}
if (isNative && stack.api !== "trpc") {
notes.api.notes.push(
"React Native requires tRPC. It will be selected automatically.",
);
notes.api.hasIssue = true;
}
if (stack.database === "mongodb" && stack.orm !== "prisma") {
notes.database.notes.push(
"MongoDB requires Prisma ORM. It will be selected automatically.",
);
notes.database.hasIssue = true;
notes.orm.hasIssue = true;
}
if (stack.database === "none") {
if (stack.orm !== "none") notes.database.hasIssue = true;
if (stack.auth === "true") notes.database.hasIssue = true;
if (stack.dbSetup !== "none") notes.database.hasIssue = true;
if (stack.examples.includes("todo")) notes.database.hasIssue = true;
}
if (stack.database === "none" && stack.orm !== "none") {
notes.orm.notes.push(
"ORM requires a database. It will be set to 'None'.",
);
notes.orm.hasIssue = true;
}
if (stack.database === "mongodb" && stack.orm !== "prisma") {
notes.orm.notes.push("MongoDB requires Prisma ORM. It will be selected.");
notes.orm.hasIssue = true;
}
if (stack.dbSetup === "turso" && stack.orm !== "drizzle") {
notes.orm.notes.push(
"Turso DB setup requires Drizzle ORM. It will be selected.",
);
notes.orm.hasIssue = true;
}
if (stack.dbSetup === "prisma-postgres" && stack.orm !== "prisma") {
notes.orm.notes.push(
"Prisma PostgreSQL setup requires Prisma ORM. It will be selected.",
);
notes.orm.hasIssue = true;
}
if (stack.dbSetup === "mongodb-atlas" && stack.orm !== "prisma") {
notes.orm.notes.push(
"MongoDB Atlas setup requires Prisma ORM. It will be selected.",
);
notes.orm.hasIssue = true;
}
if (stack.database === "none" && stack.dbSetup !== "none") {
notes.dbSetup.notes.push(
"DB Setup requires a database. It will be set to 'Basic Setup'.",
);
notes.dbSetup.hasIssue = true;
} else if (stack.dbSetup !== "none") {
const db = stack.database;
const orm = stack.orm;
if (stack.dbSetup === "turso" && (db !== "sqlite" || orm !== "drizzle")) {
notes.dbSetup.notes.push(
"Turso requires SQLite & Drizzle. They will be selected.",
);
notes.dbSetup.hasIssue = true;
if (db !== "sqlite") notes.database.hasIssue = true;
if (orm !== "drizzle") notes.orm.hasIssue = true;
} else if (
stack.dbSetup === "prisma-postgres" &&
(db !== "postgres" || orm !== "prisma")
) {
notes.dbSetup.notes.push(
"Requires PostgreSQL & Prisma. They will be selected.",
);
notes.dbSetup.hasIssue = true;
if (db !== "postgres") notes.database.hasIssue = true;
if (orm !== "prisma") notes.orm.hasIssue = true;
} else if (
stack.dbSetup === "mongodb-atlas" &&
(db !== "mongodb" || orm !== "prisma")
) {
notes.dbSetup.notes.push(
"Requires MongoDB & Prisma. They will be selected.",
);
notes.dbSetup.hasIssue = true;
if (db !== "mongodb") notes.database.hasIssue = true;
if (orm !== "prisma") notes.orm.hasIssue = true;
} else if (stack.dbSetup === "neon" && db !== "postgres") {
notes.dbSetup.notes.push(
"Neon requires PostgreSQL. It will be selected.",
);
notes.dbSetup.hasIssue = true;
if (db !== "postgres") notes.database.hasIssue = true;
}
}
if (stack.database === "none" && stack.auth === "true") {
notes.auth.notes.push(
"Authentication requires a database. It will be disabled.",
);
notes.auth.hasIssue = true;
}
if (
!isPWACompat &&
stack.addons.some((a) => ["pwa", "tauri"].includes(a))
) {
notes.addons.notes.push(
"PWA/Tauri require TanStack/React Router. They will be removed.",
);
notes.addons.hasIssue = true;
}
if (stack.addons.includes("husky") && !stack.addons.includes("biome")) {
notes.addons.notes.push(
"Husky automatically enables Biome. It will be added.",
);
}
if (!isWeb && stack.examples.length > 0) {
notes.examples.notes.push(
"Examples require a web frontend. They will be removed.",
);
notes.examples.hasIssue = true;
}
if (stack.database === "none" && stack.examples.includes("todo")) {
notes.examples.notes.push(
"Todo example requires a database. It will be removed.",
);
notes.examples.hasIssue = true;
}
if (stack.backendFramework === "elysia" && stack.examples.includes("ai")) {
notes.examples.notes.push(
"AI example is not compatible with Elysia. It will be removed.",
);
notes.examples.hasIssue = true;
notes.backendFramework.hasIssue = true;
}
setCompatNotes(notes);
}, [
stack,
generateCommand,
currentHasWebFrontend,
currentHasPWACompatibleFrontend,
currentHasNativeFrontend,
]);
const handleTechSelect = useCallback(
(category: keyof typeof TECH_OPTIONS, techId: string) => {
setStack((prev) => {
const currentStack = { ...prev };
const catKey = category as keyof StackState;
if (
catKey === "frontend" ||
catKey === "addons" ||
catKey === "examples"
) {
const currentArray = [...(currentStack[catKey] as string[])];
let nextArray = [...currentArray];
const isSelected = currentArray.includes(techId);
if (catKey === "frontend") {
const webTypes = [
"tanstack-router",
"react-router",
"tanstack-start",
"next",
];
if (techId === "none") {
nextArray = ["none"];
} else if (isSelected) {
nextArray = nextArray.filter((id) => id !== techId);
if (nextArray.length === 0) {
return prev;
}
} else {
nextArray = nextArray.filter((id) => id !== "none");
if (webTypes.includes(techId)) {
nextArray = nextArray.filter((id) => !webTypes.includes(id));
}
nextArray.push(techId);
}
} else {
if (isSelected) {
nextArray = nextArray.filter((id) => id !== techId);
} else {
nextArray.push(techId);
}
}
return { ...currentStack, [catKey]: [...new Set(nextArray)] };
}
if (currentStack[catKey] === techId) {
return prev;
}
return { ...currentStack, [catKey]: techId };
});
},
[],
);
const getDisabledReason = useCallback(
(category: keyof typeof TECH_OPTIONS, techId: string): string | null => {
const catKey = category as keyof StackState;
if (catKey === "api" && techId !== "trpc" && currentHasNativeFrontend) {
return "Only tRPC API is supported with React Native.";
}
if (catKey === "orm") {
if (stack.database === "none")
return "Select a database to enable ORM options.";
if (stack.database === "mongodb" && techId === "drizzle")
return "MongoDB requires the Prisma ORM.";
if (stack.dbSetup === "turso" && techId === "prisma")
return "Turso DB setup requires the Drizzle ORM.";
}
if (catKey === "dbSetup" && techId !== "none") {
if (stack.database === "none")
return "Select a database before choosing a cloud setup.";
if (techId === "turso") {
if (stack.database !== "sqlite")
return "Turso requires SQLite database.";
if (stack.orm === "prisma") return "Turso requires Drizzle ORM.";
} else if (techId === "prisma-postgres") {
if (stack.database !== "postgres")
return "Requires PostgreSQL database.";
if (stack.orm !== "prisma") return "Requires Prisma ORM.";
} else if (techId === "mongodb-atlas") {
if (stack.database !== "mongodb") return "Requires MongoDB database.";
if (stack.orm !== "prisma") return "Requires Prisma ORM.";
} else if (techId === "neon") {
if (stack.database !== "postgres")
return "Requires PostgreSQL database.";
}
}
if (catKey === "auth" && techId === "true" && stack.database === "none") {
return "Authentication requires a database.";
}
if (catKey === "addons") {
if (
(techId === "pwa" || techId === "tauri") &&
!currentHasPWACompatibleFrontend
) {
return "Requires TanStack Router or React Router frontend.";
}
}
if (catKey === "examples") {
if ((techId === "todo" || techId === "ai") && !currentHasWebFrontend) {
return "Requires a web frontend (TanStack Router, React Router, etc.).";
}
if (techId === "todo" && stack.database === "none") {
return "Todo example requires a database.";
}
if (techId === "ai" && stack.backendFramework === "elysia") {
return "AI example is not compatible with Elysia backend.";
}
}
return null;
},
[
stack.database,
stack.orm,
stack.dbSetup,
stack.backendFramework,
currentHasNativeFrontend,
currentHasPWACompatibleFrontend,
currentHasWebFrontend,
],
);
const copyToClipboard = useCallback(() => {
navigator.clipboard.writeText(command);
setCopied(true);
setTimeout(() => setCopied(false), 2000);
}, [command]);
const resetStack = useCallback(() => {
setStack(DEFAULT_STACK);
setProjectNameError(validateProjectName(DEFAULT_STACK.projectName || ""));
setShowHelp(false);
setShowPresets(false);
setActiveCategory(CATEGORY_ORDER[0]);
contentRef.current?.scrollTo(0, 0);
}, []);
useEffect(() => {
setProjectNameError(validateProjectName(stack.projectName || ""));
}, [stack.projectName]);
const saveCurrentStack = useCallback(() => {
localStorage.setItem("betterTStackPreference", JSON.stringify(stack));
setLastSavedStack(stack);
}, [stack]);
const loadSavedStack = useCallback(() => {
if (lastSavedStack) {
setStack(lastSavedStack);
setProjectNameError(
validateProjectName(lastSavedStack.projectName || ""),
);
setShowHelp(false);
setShowPresets(false);
setActiveCategory(CATEGORY_ORDER[0]);
contentRef.current?.scrollTo(0, 0);
}
}, [lastSavedStack]);
const applyPreset = useCallback((presetId: string) => {
const preset = PRESET_TEMPLATES.find(
(template) => template.id === presetId,
);
if (preset) {
setStack(preset.stack);
setProjectNameError(validateProjectName(preset.stack.projectName || ""));
setShowPresets(false);
setShowHelp(false);
setActiveCategory(CATEGORY_ORDER[0]);
contentRef.current?.scrollTo(0, 0);
}
}, []);
const handleSidebarClick = (category: string) => {
setActiveCategory(category);
const element = sectionRefs.current[category];
if (element) {
element.scrollIntoView({ behavior: "smooth", block: "start" });
}
};
const getCategoryDisplayName = (categoryKey: string): string => {
const result = categoryKey.replace(/([A-Z])/g, " $1");
return result.charAt(0).toUpperCase() + result.slice(1);
};
return (
<div className="flex h-screen flex-col overflow-hidden border-gray-300 bg-gray-100 text-gray-800 shadow-xl dark:border-gray-700 dark:bg-gray-900 dark:text-white">
<div className="flex flex-shrink-0 items-center justify-between border-gray-300 border-b bg-gray-200 px-2 py-2 sm:px-4 dark:border-gray-700 dark:bg-gray-800">
<div className="flex space-x-2">
<div className="h-3 w-3 rounded-full bg-red-500" />
<div className="h-3 w-3 rounded-full bg-yellow-500" />
<div className="h-3 w-3 rounded-full bg-green-500" />
</div>
<div className="hidden font-mono text-gray-600 text-xs sm:block dark:text-gray-400">
Stack Architect Terminal
</div>
<div className="flex space-x-2">
<button
type="button"
onClick={() => setShowHelp(!showHelp)}
className="text-gray-600 transition-colors hover:text-gray-800 dark:text-gray-400 dark:hover:text-white"
title="Help"
>
<HelpCircle className="h-4 w-4" />
</button>
<button
type="button"
onClick={() => setShowPresets(!showPresets)}
className="text-gray-600 transition-colors hover:text-gray-800 dark:text-gray-400 dark:hover:text-white"
title="Presets"
>
<Star className="h-4 w-4" />
</button>
</div>
</div>
{showHelp && (
<div className="flex-shrink-0 border-gray-300 border-b bg-blue-50 p-3 sm:p-4 dark:border-gray-700 dark:bg-blue-900/20">
<h3 className="mb-2 font-medium text-blue-800 text-sm dark:text-blue-300">
How to Use Stack Architect
</h3>
<ul className="list-disc space-y-1 pl-5 text-blue-700 text-xs dark:text-blue-400">
<li>Use the sidebar to navigate between configuration sections.</li>
<li>Select your preferred technologies in the main area.</li>
<li>
Some selections may disable or automatically change other options
based on compatibility (check notes within each section!).
</li>
<li>
The command below updates automatically based on your selections.
</li>
<li>
Click the copy button (
<ClipboardCopy className="inline h-3 w-3" />) next to the command
to copy it.
</li>
<li>
Use presets (<Star className="inline h-3 w-3" />) for quick setup
or reset (<RefreshCw className="inline h-3 w-3" />) to defaults.
</li>
<li>
Save (<Star className="inline h-3 w-3" />) your preferences to
load (<Settings className="inline h-3 w-3" />) them later.
</li>
</ul>
</div>
)}
{showPresets && (
<div className="flex-shrink-0 border-gray-300 border-b bg-amber-50 p-3 sm:p-4 dark:border-gray-700 dark:bg-amber-900/20">
<h3 className="mb-2 font-medium text-amber-800 text-sm dark:text-amber-300">
Quick Start Presets
</h3>
<div className="grid grid-cols-1 gap-2 sm:grid-cols-2 md:grid-cols-3 lg:grid-cols-4">
{PRESET_TEMPLATES.map((preset) => (
<button
type="button"
key={preset.id}
onClick={() => applyPreset(preset.id)}
className="rounded border border-amber-200 p-2 text-left transition-colors hover:bg-amber-100 dark:border-amber-700 dark:hover:bg-amber-800/30"
>
<div className="font-medium text-amber-700 text-sm dark:text-amber-300">
{preset.name}
</div>
<div className="text-amber-600 text-xs dark:text-amber-400">
{preset.description}
</div>
</button>
))}
</div>
</div>
)}
<div className="flex-shrink-0 p-3 font-mono sm:p-4">
<div className="mb-3 flex flex-col justify-between gap-y-3 sm:flex-row sm:items-start">
<label className="flex flex-col">
<span className="mb-1 text-gray-600 text-xs dark:text-gray-400">
Project Name:
</span>
<input
type="text"
value={stack.projectName || ""}
onChange={(e) => {
const newValue = e.target.value;
setStack((prev) => ({ ...prev, projectName: newValue }));
setProjectNameError(validateProjectName(newValue));
}}
className={`w-full rounded border px-2 py-1 font-mono text-sm focus:outline-none sm:w-auto ${
projectNameError
? "border-red-500 bg-red-50 dark:border-red-500 dark:bg-red-900/20"
: "border-gray-300 bg-gray-200 focus:border-blue-500 dark:border-gray-700 dark:bg-gray-800 dark:focus:border-blue-400"
}`}
placeholder="my-better-t-app"
/>
{projectNameError && (
<p className="mt-1 text-red-500 text-xs">{projectNameError}</p>
)}
</label>
<div className="flex flex-wrap gap-2">
<button
type="button"
onClick={resetStack}
className="flex items-center gap-1 rounded border border-gray-300 bg-gray-200 px-2 py-1 text-gray-700 text-xs transition-colors hover:bg-gray-300 dark:border-gray-700 dark:bg-gray-800 dark:text-gray-300 dark:hover:bg-gray-700"
title="Reset to defaults"
>
<RefreshCw className="h-3 w-3" />
Reset
</button>
{lastSavedStack && (
<button
type="button"
onClick={loadSavedStack}
className="flex items-center gap-1 rounded border border-blue-300 bg-blue-100 px-2 py-1 text-blue-700 text-xs transition-colors hover:bg-blue-200 dark:border-blue-700 dark:bg-blue-900/50 dark:text-blue-300 dark:hover:bg-blue-800/50"
title="Load saved preferences"
>
<Settings className="h-3 w-3" />
Load Saved
</button>
)}
<button
id="save-stack-button"
type="button"
onClick={saveCurrentStack}
className="flex items-center gap-1 rounded border border-green-300 bg-green-100 px-2 py-1 text-green-700 text-xs transition-colors hover:bg-green-200 dark:border-green-700 dark:bg-green-900/50 dark:text-green-300 dark:hover:bg-green-800/50"
title="Save current preferences"
>
<Star className="h-3 w-3" />
<span>Save</span>
</button>
</div>
</div>
<div className="relative mb-4 overflow-hidden rounded border border-gray-300 bg-gray-200 p-2 dark:border-gray-700 dark:bg-gray-800">
<div className="flex overflow-x-auto pr-10">
<span className="mr-2 select-none text-green-600 dark:text-green-400">
$
</span>
<code className="whitespace-pre break-words text-gray-700 text-xs sm:text-sm dark:text-gray-300">
{command}
</code>
</div>
<button
type="button"
onClick={copyToClipboard}
className="absolute top-1 right-1 rounded p-1 text-gray-500 transition-colors hover:bg-gray-300 hover:text-gray-700 dark:text-gray-400 dark:hover:bg-gray-700 dark:hover:text-gray-200"
title={copied ? "Copied!" : "Copy command"}
>
{copied ? (
<Check className="h-4 w-4 text-green-500" />
) : (
<ClipboardCopy className="h-4 w-4" />
)}
</button>
</div>
<div className="mb-4">
<h3 className="mb-2 font-semibold text-gray-600 text-sm dark:text-gray-400">
Selected Stack Summary
</h3>
<div className="flex flex-wrap gap-1.5">
{CATEGORY_ORDER.flatMap((category) => {
const categoryKey = category as keyof StackState;
const options =
TECH_OPTIONS[category as keyof typeof TECH_OPTIONS];
const selectedValue = stack[categoryKey];
if (!options) return [];
if (Array.isArray(selectedValue)) {
if (selectedValue.length === 0 || selectedValue[0] === "none")
return [];
return selectedValue
.map((id) => options.find((opt) => opt.id === id))
.filter((tech): tech is NonNullable<typeof tech> =>
Boolean(tech),
)
.map((tech) => (
<span
key={`${category}-${tech.id}`}
className={`inline-flex items-center gap-1 rounded-full border px-2 py-0.5 text-xs ${getBadgeColors(category)}`}
>
{tech.icon} {tech.name}
</span>
));
}
const tech = options.find((opt) => opt.id === selectedValue);
if (
!tech ||
tech.id === "none" ||
tech.id === "false" ||
((category === "git" ||
category === "install" ||
category === "auth") &&
tech.id === "true")
) {
return [];
}
return (
<span
key={`${category}-${tech.id}`}
className={`inline-flex items-center gap-1 rounded-full border px-2 py-0.5 text-xs ${getBadgeColors(category)}`}
>
{tech.icon} {tech.name}
</span>
);
})}
</div>
</div>
</div>
<div className="flex flex-grow overflow-hidden">
<nav className="w-48 flex-shrink-0 overflow-y-auto border-gray-300 border-r bg-gray-200/50 p-2 dark:border-gray-700 dark:bg-gray-800/50">
<ul className="space-y-1">
{CATEGORY_ORDER.map((category) => (
<li key={category}>
<button
type="button"
onClick={() => handleSidebarClick(category)}
className={`flex w-full items-center justify-between rounded px-2 py-1.5 text-left font-mono text-xs transition-colors ${
activeCategory === category
? "bg-blue-100 text-blue-700 dark:bg-blue-900/50 dark:text-blue-300"
: "text-gray-600 hover:bg-gray-300/50 dark:text-gray-400 dark:hover:bg-gray-700/50"
}`}
>
<span>{getCategoryDisplayName(category)}</span>
{compatNotes[category]?.hasIssue && (
<span title="Compatibility issue affects this section">
<InfoIcon className="h-3 w-3 flex-shrink-0 text-orange-500 dark:text-orange-400" />
</span>
)}
</button>
</li>
))}
</ul>
</nav>
<main
ref={contentRef}
className="flex-grow overflow-y-auto scroll-smooth p-4"
>
{CATEGORY_ORDER.map((categoryKey) => {
const categoryOptions =
TECH_OPTIONS[categoryKey as keyof typeof TECH_OPTIONS] || [];
const categoryDisplayName = getCategoryDisplayName(categoryKey);
const notesInfo = compatNotes[categoryKey];
return (
<section
ref={(el) => {
sectionRefs.current[categoryKey] = el;
}}
key={categoryKey}
id={`section-${categoryKey}`}
className="mb-8 scroll-mt-4"
>
<div className="mb-3 flex items-center border-gray-300 border-b pb-2 text-gray-700 dark:border-gray-700 dark:text-gray-300">
<Terminal className="mr-2 h-5 w-5 flex-shrink-0" />
<h2 className="font-semibold text-base">
{categoryDisplayName}
</h2>
</div>
{notesInfo?.notes && notesInfo.notes.length > 0 && (
<div
className={`mb-4 rounded-md border p-3 ${notesInfo.hasIssue ? "border-orange-200 bg-orange-50 dark:border-orange-800 dark:bg-orange-900/20" : "border-blue-200 bg-blue-50 dark:border-blue-800 dark:bg-blue-900/20"}`}
>
<div
className={`mb-1 flex items-center gap-2 font-medium text-xs sm:text-sm ${notesInfo.hasIssue ? "text-orange-800 dark:text-orange-300" : "text-blue-800 dark:text-blue-300"}`}
>
<InfoIcon className="h-4 w-4 flex-shrink-0" />
<span>
{notesInfo.hasIssue
? "Compatibility Issues / Auto-Adjustments"
: "Notes"}
</span>
</div>
<ul
className={`list-inside list-disc space-y-1 text-xs ${notesInfo.hasIssue ? "text-orange-700 dark:text-orange-400" : "text-blue-700 dark:text-blue-400"}`}
>
{notesInfo.notes.map((note, index) => (
// biome-ignore lint/suspicious/noArrayIndexKey: Static notes per render
<li key={index}>{note}</li>
))}
</ul>
</div>
)}
<div className="grid grid-cols-1 gap-3 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4">
{categoryOptions.map((tech) => {
let isSelected = false;
const category = categoryKey as keyof StackState;
if (
category === "addons" ||
category === "examples" ||
category === "frontend"
) {
isSelected = (
(stack[category] as string[]) || []
).includes(tech.id);
} else {
isSelected = stack[category] === tech.id;
}
const disabledReason = getDisabledReason(
categoryKey as keyof typeof TECH_OPTIONS,
tech.id,
);
const isDisabled = !!disabledReason;
return (
<motion.div
key={tech.id}
className={`relative rounded border p-3 transition-all ${
isDisabled
? "cursor-not-allowed opacity-60"
: "cursor-pointer"
} ${
isSelected
? "border-blue-400 bg-blue-100 ring-1 ring-blue-300 dark:border-blue-600 dark:bg-blue-900/40 dark:ring-blue-700"
: `border-gray-300 dark:border-gray-700 ${!isDisabled ? "hover:border-gray-400 hover:bg-gray-200/50 dark:hover:border-gray-600 dark:hover:bg-gray-800/50" : ""}`
}`}
title={
isDisabled
? (disabledReason ?? "Option disabled")
: tech.description
}
whileHover={!isDisabled ? { scale: 1.02 } : undefined}
whileTap={!isDisabled ? { scale: 0.98 } : undefined}
onClick={() =>
!isDisabled &&
handleTechSelect(
categoryKey as keyof typeof TECH_OPTIONS,
tech.id,
)
}
>
<div className="flex items-start">
<div className="mt-1 mr-3 flex-shrink-0">
{isSelected ? (
<CircleCheck className="h-5 w-5 text-blue-600 dark:text-blue-400" />
) : (
<Circle className="h-5 w-5 text-gray-400 dark:text-gray-600" />
)}
</div>
<div className="flex-grow">
<div className="flex items-center justify-between">
<div className="flex items-center">
<span className="mr-2 text-lg">
{tech.icon}
</span>
<span
className={`font-medium ${
isSelected
? "text-blue-800 dark:text-blue-300"
: "text-gray-800 dark:text-gray-200"
} text-sm`}
>
{tech.name}
</span>
</div>
</div>
<p className="mt-1 text-gray-600 text-xs dark:text-gray-400">
{tech.description}
</p>
</div>
</div>
{tech.default && !isSelected && !isDisabled && (
<span className="absolute top-1 right-1 ml-2 flex-shrink-0 rounded bg-gray-300 px-1 py-0.5 text-[10px] text-gray-600 dark:bg-gray-700 dark:text-gray-400">
Default
</span>
)}
</motion.div>
);
})}
</div>
</section>
);
})}
<div className="h-10" />
</main>
</div>
</div>
);
};
const getBadgeColors = (category: string): string => {
switch (category) {
case "frontend":
return "border-blue-300 bg-blue-100 text-blue-800 dark:border-blue-700/30 dark:bg-blue-900/30 dark:text-blue-300";
case "runtime":
return "border-amber-300 bg-amber-100 text-amber-800 dark:border-amber-700/30 dark:bg-amber-900/30 dark:text-amber-300";
case "backendFramework":
return "border-sky-300 bg-sky-100 text-sky-800 dark:border-sky-700/30 dark:bg-sky-900/30 dark:text-sky-300";
case "api":
return "border-indigo-300 bg-indigo-100 text-indigo-800 dark:border-indigo-700/30 dark:bg-indigo-900/30 dark:text-indigo-300";
case "database":
return "border-emerald-300 bg-emerald-100 text-emerald-800 dark:border-emerald-700/30 dark:bg-emerald-900/30 dark:text-emerald-300";
case "orm":
return "border-cyan-300 bg-cyan-100 text-cyan-800 dark:border-cyan-700/30 dark:bg-cyan-900/30 dark:text-cyan-300";
case "auth":
return "border-green-300 bg-green-100 text-green-800 dark:border-green-700/30 dark:bg-green-900/30 dark:text-green-300";
case "dbSetup":
return "border-pink-300 bg-pink-100 text-pink-800 dark:border-pink-700/30 dark:bg-pink-900/30 dark:text-pink-300";
case "addons":
return "border-violet-300 bg-violet-100 text-violet-800 dark:border-violet-700/30 dark:bg-violet-900/30 dark:text-violet-300";
case "examples":
return "border-teal-300 bg-teal-100 text-teal-800 dark:border-teal-700/30 dark:bg-teal-900/30 dark:text-teal-300";
case "packageManager":
return "border-orange-300 bg-orange-100 text-orange-800 dark:border-orange-700/30 dark:bg-orange-900/30 dark:text-orange-300";
case "git":
case "install":
return "border-gray-300 bg-gray-100 text-gray-700 dark:border-gray-600 dark:bg-gray-800 dark:text-gray-400";
default:
return "border-gray-300 bg-gray-100 text-gray-800 dark:border-gray-700/30 dark:bg-gray-900/30 dark:text-gray-300";
}
};
export default StackArchitect;