Files
create-better-t-stack/apps/web/src/app/(home)/_components/StackArchitech.tsx
2025-05-10 22:28:05 +05:30

1948 lines
57 KiB
TypeScript

"use client";
import { ThemeToggle } from "@/components/theme-toggle";
import { ScrollArea } from "@/components/ui/scroll-area";
import {
Tooltip,
TooltipContent,
TooltipProvider,
TooltipTrigger,
} from "@/components/ui/tooltip";
import {
DEFAULT_STACK,
PRESET_TEMPLATES,
type StackState,
TECH_OPTIONS,
isStackDefault,
} from "@/lib/constant";
import { stackParsers, stackQueryStatesOptions } from "@/lib/stack-url-state";
import { cn } from "@/lib/utils";
import {
Check,
Circle,
CircleCheck,
ClipboardCopy,
Github,
HelpCircle,
InfoIcon,
RefreshCw,
Settings,
Share2,
Shuffle,
Star,
Terminal,
} from "lucide-react";
import { motion } from "motion/react";
import Image from "next/image";
import Link from "next/link";
import { useQueryStates } from "nuqs";
import type React from "react";
import { useEffect, useMemo, useRef, useState } from "react";
import { toast } from "sonner";
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",
"backend",
"runtime",
"api",
"database",
"orm",
"dbSetup",
"auth",
"packageManager",
"addons",
"examples",
"git",
"install",
];
const hasWebFrontend = (frontend: string[]) =>
frontend.some((f) =>
[
"tanstack-router",
"react-router",
"tanstack-start",
"next",
"nuxt",
"svelte",
"solid",
].includes(f),
);
const checkHasNativeFrontend = (frontend: string[]) =>
frontend.includes("native-nativewind") ||
frontend.includes("native-unistyles");
const hasPWACompatibleFrontend = (frontend: string[]) =>
frontend.some((f) =>
["tanstack-router", "react-router", "solid"].includes(f),
);
const hasTauriCompatibleFrontend = (frontend: string[]) =>
frontend.some((f) =>
["tanstack-router", "react-router", "nuxt", "svelte", "solid"].includes(f),
);
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 "backend":
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";
}
};
const TechIcon: React.FC<{
icon: string;
name: string;
className?: string;
}> = ({ icon, name, className }) => {
if (icon.startsWith("/icon/")) {
return (
<Image
src={icon}
alt={`${name} icon`}
width={20}
height={20}
className={cn("inline-block", className)}
unoptimized
/>
);
}
return (
<span className={cn("inline-flex items-center text-lg", className)}>
{icon}
</span>
);
};
const getCategoryDisplayName = (categoryKey: string): string => {
const result = categoryKey.replace(/([A-Z])/g, " $1");
return result.charAt(0).toUpperCase() + result.slice(1);
};
interface CompatibilityResult {
adjustedStack: StackState | null;
notes: Record<string, { notes: string[]; hasIssue: boolean }>;
changes: Array<{ category: string; message: string }>;
}
const analyzeStackCompatibility = (stack: StackState): CompatibilityResult => {
const nextStack = { ...stack };
let changed = false;
const notes: CompatibilityResult["notes"] = {};
const changes: Array<{ category: string; message: string }> = [];
for (const cat of CATEGORY_ORDER) {
notes[cat] = { notes: [], hasIssue: false };
}
const isConvex = nextStack.backend === "convex";
const isBackendNone = nextStack.backend === "none";
if (isConvex) {
const convexOverrides: Partial<StackState> = {
runtime: "none",
database: "none",
orm: "none",
api: "none",
auth: "false",
dbSetup: "none",
examples: ["todo"],
};
for (const [key, value] of Object.entries(convexOverrides)) {
const catKey = key as keyof StackState;
if (JSON.stringify(nextStack[catKey]) !== JSON.stringify(value)) {
const displayName = getCategoryDisplayName(catKey);
const valueDisplay = Array.isArray(value) ? value.join(", ") : value;
const message = `${displayName} set to '${valueDisplay}'`;
notes[catKey].notes.push(
`Convex backend selected: ${displayName} will be set to '${valueDisplay}'.`,
);
notes.backend.notes.push(
`Convex requires ${displayName} to be '${valueDisplay}'.`,
);
notes[catKey].hasIssue = true;
notes.backend.hasIssue = true;
(nextStack[catKey] as string | string[]) = value;
changed = true;
changes.push({
category: "convex",
message,
});
}
}
const incompatibleConvexFrontends = ["nuxt", "solid"];
const originalFrontendLength = nextStack.frontend.length;
nextStack.frontend = nextStack.frontend.filter(
(f) => !incompatibleConvexFrontends.includes(f),
);
if (nextStack.frontend.length !== originalFrontendLength) {
changed = true;
notes.frontend.notes.push(
"Nuxt and Solid are not compatible with Convex backend and have been removed.",
);
notes.backend.notes.push(
"Convex backend is not compatible with Nuxt or Solid.",
);
notes.frontend.hasIssue = true;
notes.backend.hasIssue = true;
changes.push({
category: "convex",
message: "Removed incompatible frontends (Nuxt, Solid)",
});
}
if (nextStack.frontend.length === 0) {
nextStack.frontend = ["tanstack-router"];
changed = true;
changes.push({
category: "convex",
message: "Frontend defaulted to TanStack Router",
});
}
} else if (isBackendNone) {
const noneOverrides: Partial<StackState> = {
auth: "false",
database: "none",
orm: "none",
api: "none",
runtime: "none",
dbSetup: "none",
examples: [],
};
for (const [key, value] of Object.entries(noneOverrides)) {
const catKey = key as keyof StackState;
if (JSON.stringify(nextStack[catKey]) !== JSON.stringify(value)) {
const displayName = getCategoryDisplayName(catKey);
const valueDisplay = Array.isArray(value) ? "none" : value;
const message = `${displayName} set to '${valueDisplay}'`;
notes[catKey].notes.push(
`No backend selected: ${displayName} will be set to '${valueDisplay}'.`,
);
notes.backend.notes.push(
`No backend requires ${displayName} to be '${valueDisplay}'.`,
);
notes[catKey].hasIssue = true;
notes[catKey].hasIssue = true;
(nextStack[catKey] as string | string[]) = value;
changed = true;
changes.push({
category: "backend-none",
message,
});
}
}
} else {
if (nextStack.runtime === "none") {
notes.runtime.notes.push(
"Runtime 'None' is only for Convex. Defaulting to 'Bun'.",
);
notes.runtime.hasIssue = true;
nextStack.runtime = DEFAULT_STACK.runtime;
changed = true;
changes.push({
category: "runtime",
message: "Runtime set to 'Bun' (None is only for Convex)",
});
}
if (nextStack.api === "none" && (isConvex || isBackendNone)) {
} else if (nextStack.api === "none" && !(isConvex || isBackendNone)) {
}
if (nextStack.database === "none") {
if (nextStack.orm !== "none") {
notes.database.notes.push(
"Database 'None' selected: ORM will be set to 'None'.",
);
notes.orm.notes.push(
"ORM requires a database. It will be set to 'None'.",
);
notes.database.hasIssue = true;
notes.orm.hasIssue = true;
nextStack.orm = "none";
changed = true;
changes.push({
category: "database",
message: "ORM set to 'None' (requires a database)",
});
}
if (nextStack.auth === "true") {
notes.database.notes.push(
"Database 'None' selected: Auth will be disabled.",
);
notes.auth.notes.push(
"Authentication requires a database. It will be disabled.",
);
notes.database.hasIssue = true;
notes.auth.hasIssue = true;
nextStack.auth = "false";
changed = true;
changes.push({
category: "database",
message: "Authentication disabled (requires a database)",
});
}
if (nextStack.dbSetup !== "none") {
notes.database.notes.push(
"Database 'None' selected: DB Setup will be set to 'Basic'.",
);
notes.dbSetup.notes.push(
"DB Setup requires a database. It will be set to 'Basic Setup'.",
);
notes.database.hasIssue = true;
notes.dbSetup.hasIssue = true;
nextStack.dbSetup = "none";
changed = true;
changes.push({
category: "database",
message: "DB Setup set to 'None' (requires a database)",
});
}
} else if (nextStack.database === "mongodb") {
if (nextStack.orm !== "prisma" && nextStack.orm !== "mongoose") {
notes.database.notes.push(
"MongoDB requires Prisma or Mongoose ORM. Prisma will be selected.",
);
notes.orm.notes.push(
"MongoDB requires Prisma or Mongoose ORM. Prisma will be selected.",
);
notes.database.hasIssue = true;
notes.orm.hasIssue = true;
nextStack.orm = "prisma";
changed = true;
changes.push({
category: "database",
message: "ORM set to 'Prisma' (MongoDB requires Prisma or Mongoose)",
});
}
} else {
if (nextStack.orm === "mongoose") {
notes.database.notes.push(
"Relational databases are not compatible with Mongoose ORM. Defaulting to Drizzle.",
);
notes.orm.notes.push(
"Mongoose ORM only works with MongoDB. Defaulting to Drizzle.",
);
notes.database.hasIssue = true;
notes.orm.hasIssue = true;
nextStack.orm = "drizzle";
changed = true;
changes.push({
category: "database",
message: "ORM set to 'Drizzle' (Mongoose only works with MongoDB)",
});
}
if (nextStack.dbSetup === "turso") {
if (nextStack.database !== "sqlite") {
notes.dbSetup.notes.push(
"Turso requires SQLite. It will be selected.",
);
notes.database.notes.push(
"Turso DB setup requires SQLite. It will be selected.",
);
notes.dbSetup.hasIssue = true;
notes.database.hasIssue = true;
nextStack.database = "sqlite";
changed = true;
changes.push({
category: "dbSetup",
message: "Database set to 'SQLite' (required by Turso)",
});
}
if (nextStack.orm !== "drizzle") {
notes.dbSetup.notes.push(
"Turso requires Drizzle ORM. It will be selected.",
);
notes.orm.notes.push(
"Turso DB setup requires Drizzle ORM. It will be selected.",
);
notes.dbSetup.hasIssue = true;
notes.orm.hasIssue = true;
nextStack.orm = "drizzle";
changed = true;
changes.push({
category: "dbSetup",
message: "ORM set to 'Drizzle' (required by Turso)",
});
}
} else if (nextStack.dbSetup === "prisma-postgres") {
if (nextStack.database !== "postgres") {
notes.dbSetup.notes.push("Requires PostgreSQL. It will be selected.");
notes.database.notes.push(
"Prisma PostgreSQL setup requires PostgreSQL. It will be selected.",
);
notes.dbSetup.hasIssue = true;
notes.database.hasIssue = true;
nextStack.database = "postgres";
changed = true;
changes.push({
category: "dbSetup",
message:
"Database set to 'PostgreSQL' (required by Prisma PostgreSQL setup)",
});
}
if (nextStack.orm !== "prisma") {
notes.dbSetup.notes.push("Requires Prisma ORM. It will be selected.");
notes.orm.notes.push(
"Prisma PostgreSQL setup requires Prisma ORM. It will be selected.",
);
notes.dbSetup.hasIssue = true;
notes.orm.hasIssue = true;
nextStack.orm = "prisma";
changed = true;
changes.push({
category: "dbSetup",
message:
"ORM set to 'Prisma' (required by Prisma PostgreSQL setup)",
});
}
} else if (nextStack.dbSetup === "mongodb-atlas") {
if (nextStack.database !== "mongodb") {
notes.dbSetup.notes.push("Requires MongoDB. It will be selected.");
notes.database.notes.push(
"MongoDB Atlas setup requires MongoDB. It will be selected.",
);
notes.dbSetup.hasIssue = true;
notes.database.hasIssue = true;
nextStack.database = "mongodb";
changed = true;
changes.push({
category: "dbSetup",
message:
"Database set to 'MongoDB' (required by MongoDB Atlas setup)",
});
}
if (nextStack.orm !== "prisma" && nextStack.orm !== "mongoose") {
notes.dbSetup.notes.push(
"Requires Prisma or Mongoose ORM. Prisma will be selected.",
);
notes.orm.notes.push(
"MongoDB Atlas setup requires Prisma or Mongoose ORM. Prisma will be selected.",
);
notes.dbSetup.hasIssue = true;
notes.orm.hasIssue = true;
nextStack.orm = "prisma";
changed = true;
changes.push({
category: "dbSetup",
message:
"ORM set to 'Prisma' (MongoDB Atlas requires Prisma or Mongoose)",
});
}
} else if (nextStack.dbSetup === "neon") {
if (nextStack.database !== "postgres") {
notes.dbSetup.notes.push(
"Neon requires PostgreSQL. It will be selected.",
);
notes.database.notes.push(
"Neon DB setup requires PostgreSQL. It will be selected.",
);
notes.dbSetup.hasIssue = true;
notes.database.hasIssue = true;
nextStack.database = "postgres";
changed = true;
changes.push({
category: "dbSetup",
message: "Database set to 'PostgreSQL' (required by Neon)",
});
}
}
const isNuxt = nextStack.frontend.includes("nuxt");
const isSvelte = nextStack.frontend.includes("svelte");
const isSolid = nextStack.frontend.includes("solid");
if ((isNuxt || isSvelte || isSolid) && nextStack.api === "trpc") {
const frontendName = isNuxt ? "Nuxt" : isSvelte ? "Svelte" : "Solid";
notes.api.notes.push(
`${frontendName} requires oRPC. It will be selected automatically.`,
);
notes.frontend.notes.push(
`Selected ${frontendName}: API will be set to oRPC.`,
);
notes.api.hasIssue = true;
notes.frontend.hasIssue = true;
nextStack.api = "orpc";
changed = true;
changes.push({
category: "api",
message: `API set to 'oRPC' (required by ${frontendName})`,
});
}
const incompatibleAddons: string[] = [];
const isPWACompat = hasPWACompatibleFrontend(nextStack.frontend);
const isTauriCompat = hasTauriCompatibleFrontend(nextStack.frontend);
if (!isPWACompat && nextStack.addons.includes("pwa")) {
incompatibleAddons.push("pwa");
notes.frontend.notes.push(
"PWA addon requires TanStack/React Router or Solid. Addon will be removed.",
);
notes.addons.notes.push(
"PWA requires TanStack/React Router/Solid. It will be removed.",
);
notes.frontend.hasIssue = true;
notes.addons.hasIssue = true;
changes.push({
category: "addons",
message: "PWA addon removed (requires compatible frontend)",
});
}
if (!isTauriCompat && nextStack.addons.includes("tauri")) {
incompatibleAddons.push("tauri");
notes.frontend.notes.push(
"Tauri addon requires TanStack/React Router, Nuxt, Svelte or Solid. Addon will be removed.",
);
notes.addons.notes.push(
"Tauri requires TanStack/React Router/Nuxt/Svelte/Solid. It will be removed.",
);
notes.frontend.hasIssue = true;
notes.addons.hasIssue = true;
changes.push({
category: "addons",
message: "Tauri addon removed (requires compatible frontend)",
});
}
const originalAddonsLength = nextStack.addons.length;
if (incompatibleAddons.length > 0) {
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")
) {
notes.addons.notes.push(
"Husky addon is selected without Biome. Consider adding Biome for lint-staged integration.",
);
}
const incompatibleExamples: string[] = [];
const isWeb = hasWebFrontend(nextStack.frontend);
const isNativeOnly = checkHasNativeFrontend(nextStack.frontend) && !isWeb;
if (isNativeOnly) {
if (nextStack.examples.length > 0) {
notes.frontend.notes.push(
"Examples are not supported with Native-only frontend. Examples will be removed.",
);
notes.examples.notes.push(
"Examples require a web frontend. They will be removed.",
);
notes.frontend.hasIssue = true;
notes.examples.hasIssue = true;
incompatibleExamples.push(...nextStack.examples);
changes.push({
category: "examples",
message:
"Examples removed (not supported with Native-only frontend)",
});
}
} else {
if (!isWeb) {
if (nextStack.examples.includes("todo")) {
incompatibleExamples.push("todo");
changes.push({
category: "examples",
message: "Todo example removed (requires web frontend)",
});
}
if (nextStack.examples.includes("ai")) {
incompatibleExamples.push("ai");
changes.push({
category: "examples",
message: "AI example removed (requires web frontend)",
});
}
}
if (
nextStack.database === "none" &&
nextStack.examples.includes("todo")
) {
incompatibleExamples.push("todo");
changes.push({
category: "examples",
message: "Todo example removed (requires a database)",
});
}
if (
nextStack.backend === "elysia" &&
nextStack.examples.includes("ai")
) {
incompatibleExamples.push("ai");
changes.push({
category: "examples",
message: "AI example removed (not compatible with Elysia)",
});
}
if (isSolid && nextStack.examples.includes("ai")) {
incompatibleExamples.push("ai");
changes.push({
category: "examples",
message: "AI example removed (not compatible with Solid)",
});
}
}
const uniqueIncompatibleExamples = [...new Set(incompatibleExamples)];
if (uniqueIncompatibleExamples.length > 0) {
if (!isWeb && !isNativeOnly) {
if (
uniqueIncompatibleExamples.includes("todo") ||
uniqueIncompatibleExamples.includes("ai")
) {
notes.frontend.notes.push(
"Examples require a web frontend. Incompatible examples will be removed.",
);
notes.examples.notes.push(
"Requires a web frontend. Incompatible examples will be removed.",
);
notes.frontend.hasIssue = true;
notes.examples.hasIssue = true;
}
}
if (
nextStack.database === "none" &&
uniqueIncompatibleExamples.includes("todo")
) {
notes.database.notes.push(
"Todo example requires a database. It will be removed.",
);
notes.examples.notes.push(
"Todo example requires a database. It will be removed.",
);
notes.database.hasIssue = true;
notes.examples.hasIssue = true;
}
if (
nextStack.backend === "elysia" &&
uniqueIncompatibleExamples.includes("ai")
) {
notes.backend.notes.push(
"AI example is not compatible with Elysia. It will be removed.",
);
notes.examples.notes.push(
"AI example is not compatible with Elysia. It will be removed.",
);
notes.backend.hasIssue = true;
notes.examples.hasIssue = true;
}
if (isSolid && uniqueIncompatibleExamples.includes("ai")) {
notes.frontend.notes.push(
"AI example is not compatible with Solid. It will be removed.",
);
notes.examples.notes.push(
"AI example is not compatible with Solid. It will be removed.",
);
notes.frontend.hasIssue = true;
notes.examples.hasIssue = true;
}
const originalExamplesLength = nextStack.examples.length;
nextStack.examples = nextStack.examples.filter(
(ex) => !uniqueIncompatibleExamples.includes(ex),
);
if (nextStack.examples.length !== originalExamplesLength)
changed = true;
}
}
}
return {
adjustedStack: changed ? nextStack : null,
notes,
changes,
};
};
const getCompatibilityRules = (stack: StackState) => {
const isConvex = stack.backend === "convex";
const isBackendNone = stack.backend === "none";
const hasWebFrontendSelected = hasWebFrontend(stack.frontend);
const hasNativeFrontend = checkHasNativeFrontend(stack.frontend);
const hasNativeOnly = hasNativeFrontend && !hasWebFrontendSelected;
const hasSolid = stack.frontend.includes("solid");
const hasNuxt = stack.frontend.includes("nuxt");
const hasSvelte = stack.frontend.includes("svelte");
return {
isConvex,
isBackendNone,
hasWebFrontend: hasWebFrontendSelected,
hasNativeFrontend,
hasNativeOnly,
hasPWACompatible: hasPWACompatibleFrontend(stack.frontend),
hasTauriCompatible: hasTauriCompatibleFrontend(stack.frontend),
hasNuxtOrSvelteOrSolid: hasNuxt || hasSvelte || hasSolid,
hasSolid,
hasNuxt,
hasSvelte,
};
};
const generateCommand = (stackState: StackState): string => {
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[] = ["--yes"];
const checkDefault = <K extends keyof StackState>(
key: K,
value: StackState[K],
) => isStackDefault(stackState, key, value);
if (!checkDefault("frontend", stackState.frontend)) {
if (stackState.frontend.length === 0 || stackState.frontend[0] === "none") {
flags.push("--frontend none");
} else {
flags.push(`--frontend ${stackState.frontend.join(" ")}`);
}
}
if (!checkDefault("backend", stackState.backend)) {
flags.push(`--backend ${stackState.backend}`);
}
if (stackState.backend !== "convex") {
if (!checkDefault("runtime", stackState.runtime)) {
flags.push(`--runtime ${stackState.runtime}`);
}
if (!checkDefault("api", stackState.api)) {
flags.push(`--api ${stackState.api}`);
}
if (!checkDefault("database", stackState.database)) {
flags.push(`--database ${stackState.database}`);
}
if (!checkDefault("orm", stackState.orm)) {
flags.push(`--orm ${stackState.orm}`);
}
if (!checkDefault("auth", stackState.auth)) {
if (stackState.auth === "false" && DEFAULT_STACK.auth === "true") {
flags.push("--no-auth");
}
}
if (!checkDefault("dbSetup", stackState.dbSetup)) {
flags.push(`--db-setup ${stackState.dbSetup}`);
}
} else {
}
if (!checkDefault("packageManager", stackState.packageManager)) {
flags.push(`--package-manager ${stackState.packageManager}`);
}
if (!checkDefault("git", stackState.git)) {
if (stackState.git === "false" && DEFAULT_STACK.git === "true") {
flags.push("--no-git");
}
}
if (!checkDefault("install", stackState.install)) {
if (stackState.install === "false" && DEFAULT_STACK.install === "true") {
flags.push("--no-install");
}
}
if (!checkDefault("addons", stackState.addons)) {
if (stackState.addons.length > 0) {
flags.push(`--addons ${stackState.addons.join(" ")}`);
} else {
if (DEFAULT_STACK.addons.length > 0) {
flags.push("--addons none");
}
}
}
if (!checkDefault("examples", stackState.examples)) {
if (stackState.examples.length > 0) {
flags.push(`--examples ${stackState.examples.join(" ")}`);
} else {
if (DEFAULT_STACK.examples.length > 0) {
flags.push("--examples none");
}
}
}
return `${base} ${projectName}${
flags.length > 0 ? ` ${flags.join(" ")}` : ""
}`;
};
const StackArchitect = () => {
const [stack, setStack] = useQueryStates(
stackParsers,
stackQueryStatesOptions,
);
const [command, setCommand] = useState("");
const [copied, setCopied] = useState(false);
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 [, setLastChanges] = useState<
Array<{ category: string; message: string }>
>([]);
const sectionRefs = useRef<Record<string, HTMLElement | null>>({});
const contentRef = useRef<HTMLDivElement>(null);
const compatibilityAnalysis = useMemo(
() => analyzeStackCompatibility(stack),
[stack],
);
const rules = useMemo(() => getCompatibilityRules(stack), [stack]);
const getRandomStack = () => {
const randomStack: Partial<StackState> = {};
for (const category of CATEGORY_ORDER) {
const options = TECH_OPTIONS[category as keyof typeof TECH_OPTIONS] || [];
if (options.length === 0) continue;
const catKey = category as keyof StackState;
if (["frontend", "addons", "examples"].includes(catKey)) {
const currentValues: string[] = [];
randomStack[catKey as "frontend" | "addons" | "examples"] =
currentValues;
if (catKey === "frontend") {
const randomIndex = Math.floor(Math.random() * options.length);
const selectedOption = options[randomIndex].id;
currentValues.push(selectedOption);
if (selectedOption === "none" && currentValues.length > 1) {
randomStack[catKey] = ["none"];
} else if (selectedOption !== "none") {
randomStack[catKey] = currentValues.filter((id) => id !== "none");
}
} else {
const numToPick = Math.floor(
Math.random() * Math.min(options.length + 1, 4),
);
const shuffledOptions = [...options].sort(() => 0.5 - Math.random());
for (let i = 0; i < numToPick; i++) {
currentValues.push(shuffledOptions[i].id);
}
}
} else {
const randomIndex = Math.floor(Math.random() * options.length);
(randomStack[catKey] as string) = options[randomIndex].id;
}
}
setStack(randomStack as StackState);
setShowHelp(false);
setShowPresets(false);
setActiveCategory(CATEGORY_ORDER[0]);
contentRef.current?.scrollTo(0, 0);
toast.success("Random stack generated!");
};
const shareToTwitter = () => {
const text = encodeURIComponent(
"Check out this cool tech stack I configured with Create Better T-Stack!\n\n",
);
if (typeof window !== "undefined") {
const url = encodeURIComponent(window.location.href);
window.open(
`https://twitter.com/intent/tweet?text=${text}&url=${url}`,
"_blank",
);
} else {
toast.error("Could not generate share link.");
}
};
const disabledReasons = useMemo(() => {
const reasons = new Map<string, string>();
const addRule = (category: string, techId: string, reason: string) => {
reasons.set(`${category}-${techId}`, reason);
};
for (const category of CATEGORY_ORDER) {
const options = TECH_OPTIONS[category as keyof typeof TECH_OPTIONS] || [];
const catKey = category as keyof StackState;
for (const tech of options) {
const techId = tech.id;
if (rules.isConvex) {
const convexDefaults: Record<string, string | string[]> = {
runtime: "none",
database: "none",
orm: "none",
api: "none",
auth: "false",
dbSetup: "none",
examples: ["todo"],
};
if (
["runtime", "database", "orm", "api", "auth", "dbSetup"].includes(
catKey,
)
) {
const requiredValue = convexDefaults[catKey];
if (catKey === "auth") {
if (techId === "true" && requiredValue === "false") {
addRule(
category,
techId,
"Disabled: Convex backend requires Authentication to be disabled.",
);
}
} else if (String(techId) !== String(requiredValue)) {
addRule(
category,
techId,
`Disabled: Convex backend requires ${getCategoryDisplayName(
catKey,
)} to be '${requiredValue}'.`,
);
}
} else if (catKey === "examples") {
const requiredExamples = convexDefaults.examples as string[];
if (
!requiredExamples.includes(techId) &&
techId !== "none" &&
options.find((o) => o.id === techId)
) {
addRule(
category,
techId,
"Disabled: Convex backend only supports the 'Todo' example.",
);
}
} else if (
catKey === "frontend" &&
(techId === "nuxt" || techId === "solid")
) {
addRule(
category,
techId,
`Disabled: Convex backend is not compatible with ${tech.name}.`,
);
}
continue;
}
if (rules.isBackendNone) {
if (catKey === "auth" && techId === "true") {
addRule(
category,
techId,
"Disabled: Authentication requires a backend.",
);
} else if (
["database", "orm", "api", "runtime", "dbSetup"].includes(catKey) &&
techId !== "none"
) {
addRule(
category,
techId,
`Disabled: ${getCategoryDisplayName(
catKey,
)} cannot be selected when 'No Backend' is chosen (will be 'None').`,
);
} else if (catKey === "examples" && techId !== "none") {
addRule(
category,
techId,
"Disabled: Examples cannot be selected when 'No Backend' is chosen.",
);
}
}
if (catKey === "runtime" && techId === "none" && !rules.isConvex) {
addRule(
category,
techId,
"Disabled: Runtime 'None' is only available with Convex backend.",
);
}
if (catKey === "api") {
if (techId !== "none" && (rules.isConvex || rules.isBackendNone)) {
addRule(
category,
techId,
rules.isConvex
? "Disabled: Convex backend requires API to be 'None'."
: "Disabled: No backend requires API to be 'None'.",
);
}
if (techId === "trpc" && rules.hasNuxtOrSvelteOrSolid) {
const frontendName = rules.hasNuxt
? "Nuxt"
: rules.hasSvelte
? "Svelte"
: "Solid";
addRule(
category,
techId,
`Disabled: tRPC is not supported with ${frontendName}. oRPC will be automatically selected.`,
);
}
}
if (catKey === "orm") {
if (
stack.database === "none" &&
techId !== "none" &&
!rules.isConvex
) {
addRule(
category,
techId,
"Disabled: ORM requires a database. Select a database or 'No ORM'.",
);
} else if (stack.database === "mongodb") {
if (
techId !== "prisma" &&
techId !== "mongoose" &&
techId !== "none"
) {
addRule(
category,
techId,
"Disabled: With MongoDB, use Prisma, Mongoose, or No ORM.",
);
}
} else if (["sqlite", "postgres", "mysql"].includes(stack.database)) {
if (techId === "mongoose") {
addRule(
category,
techId,
"Disabled: Mongoose ORM is for MongoDB. Choose a different ORM for relational databases.",
);
}
}
if (stack.dbSetup === "turso" && techId !== "drizzle") {
addRule(
category,
techId,
"Disabled: Turso DB setup requires Drizzle ORM.",
);
} else if (
stack.dbSetup === "prisma-postgres" &&
techId !== "prisma"
) {
addRule(
category,
techId,
"Disabled: Prisma PostgreSQL setup requires Prisma ORM.",
);
} else if (
stack.dbSetup === "mongodb-atlas" &&
techId !== "prisma" &&
techId !== "mongoose"
) {
addRule(
category,
techId,
"Disabled: MongoDB Atlas setup requires Prisma or Mongoose ORM.",
);
}
}
if (catKey === "dbSetup" && techId !== "none") {
if (stack.database === "none" && !rules.isBackendNone) {
addRule(
category,
techId,
"Disabled: A database must be selected to use this DB setup. Select 'Basic Setup' or a database first.",
);
}
if (techId === "turso") {
if (stack.database !== "sqlite" && stack.database !== "none") {
addRule(
category,
techId,
"Disabled: Turso requires SQLite. (Will auto-select if chosen)",
);
}
if (stack.orm !== "drizzle" && stack.orm !== "none") {
addRule(
category,
techId,
"Disabled: Turso requires Drizzle ORM. (Will auto-select if chosen)",
);
}
} else if (techId === "prisma-postgres") {
if (stack.database !== "postgres" && stack.database !== "none") {
addRule(
category,
techId,
"Disabled: Requires PostgreSQL. (Will auto-select if chosen)",
);
}
if (stack.orm !== "prisma" && stack.orm !== "none") {
addRule(
category,
techId,
"Disabled: Requires Prisma ORM. (Will auto-select if chosen)",
);
}
} else if (techId === "mongodb-atlas") {
if (stack.database !== "mongodb" && stack.database !== "none") {
addRule(
category,
techId,
"Disabled: Requires MongoDB. (Will auto-select if chosen)",
);
}
if (
stack.orm !== "prisma" &&
stack.orm !== "mongoose" &&
stack.orm !== "none"
) {
addRule(
category,
techId,
"Disabled: Requires Prisma or Mongoose ORM. (Will auto-select Prisma if chosen)",
);
}
} else if (techId === "neon") {
if (stack.database !== "postgres" && stack.database !== "none") {
addRule(
category,
techId,
"Disabled: Neon requires PostgreSQL. (Will auto-select if chosen)",
);
}
}
}
if (catKey === "auth" && techId === "true") {
if (stack.database === "none" && !rules.isBackendNone) {
addRule(
category,
techId,
"Disabled: Authentication requires a database.",
);
}
}
if (catKey === "addons") {
if (techId === "pwa" && !rules.hasPWACompatible) {
addRule(
category,
techId,
"Disabled: PWA addon requires a compatible frontend (e.g., TanStack Router, Solid).",
);
}
if (techId === "tauri" && !rules.hasTauriCompatible) {
addRule(
category,
techId,
"Disabled: Tauri addon requires a compatible frontend (e.g., TanStack Router, Nuxt, Svelte, Solid).",
);
}
}
if (catKey === "examples" && techId !== "none") {
if (rules.hasNativeOnly) {
addRule(
category,
techId,
"Disabled: Examples are not supported with a Native-only frontend.",
);
} else {
if (
!rules.hasWebFrontend &&
(techId === "todo" || techId === "ai")
) {
addRule(
category,
techId,
"Disabled: This example requires a web frontend.",
);
}
if (
stack.database === "none" &&
techId === "todo" &&
!rules.isConvex
) {
addRule(
category,
techId,
"Disabled: The 'Todo' example requires a database.",
);
}
if (stack.backend === "elysia" && techId === "ai") {
addRule(
category,
techId,
"Disabled: The 'AI' example is not compatible with an Elysia backend.",
);
}
if (rules.hasSolid && techId === "ai") {
addRule(
category,
techId,
"Disabled: The 'AI' example is not compatible with a Solid frontend.",
);
}
}
}
}
}
return reasons;
}, [stack, rules]);
const selectedBadges = (() => {
const badges: React.ReactNode[] = [];
for (const category of CATEGORY_ORDER) {
const categoryKey = category as keyof StackState;
const options = TECH_OPTIONS[category as keyof typeof TECH_OPTIONS];
const selectedValue = stack[categoryKey];
if (!options) continue;
if (Array.isArray(selectedValue)) {
if (selectedValue.length === 0 || selectedValue[0] === "none") continue;
for (const id of selectedValue) {
const tech = options.find((opt) => opt.id === id);
if (tech) {
badges.push(
<span
key={`${category}-${tech.id}`}
className={cn(
"inline-flex items-center gap-1.5 rounded-full border px-2 py-0.5 text-xs",
getBadgeColors(category),
)}
>
<TechIcon
icon={tech.icon}
name={tech.name}
className={
tech.icon.startsWith("/icon/")
? "h-3 w-3"
: "h-3 w-3 text-xs"
}
/>
{tech.name}
</span>,
);
}
}
} else {
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")
) {
continue;
}
badges.push(
<span
key={`${category}-${tech.id}`}
className={cn(
"inline-flex items-center gap-1.5 rounded-full border px-2 py-0.5 text-xs",
getBadgeColors(category),
)}
>
<TechIcon icon={tech.icon} name={tech.name} className="h-3 w-3" />
{tech.name}
</span>,
);
}
}
return badges;
})();
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");
}
}
}, []);
useEffect(() => {
if (compatibilityAnalysis.adjustedStack) {
if (compatibilityAnalysis.changes.length > 0) {
}
setLastChanges(compatibilityAnalysis.changes);
setStack(compatibilityAnalysis.adjustedStack);
}
}, [
compatibilityAnalysis.adjustedStack,
setStack,
compatibilityAnalysis.changes,
]);
useEffect(() => {
const cmd = generateCommand(stack);
setCommand(cmd);
}, [stack]);
useEffect(() => {
setProjectNameError(validateProjectName(stack.projectName || ""));
}, [stack.projectName]);
const handleTechSelect = (
category: keyof typeof TECH_OPTIONS,
techId: string,
) => {
setStack((currentStack) => {
const catKey = category as keyof StackState;
const update: Partial<StackState> = {};
const currentValue = currentStack[catKey];
if (
catKey === "frontend" ||
catKey === "addons" ||
catKey === "examples"
) {
const currentArray = Array.isArray(currentValue)
? [...currentValue]
: [];
let nextArray = [...currentArray];
const isSelected = currentArray.includes(techId);
if (catKey === "frontend") {
const webTypes = [
"tanstack-router",
"react-router",
"tanstack-start",
"next",
"nuxt",
"svelte",
"solid",
];
if (techId === "none") {
nextArray = ["none"];
} else if (isSelected) {
if (currentArray.length > 1) {
nextArray = nextArray.filter((id) => id !== techId);
} else {
nextArray = ["none"];
}
} else {
nextArray = nextArray.filter((id) => id !== "none");
if (webTypes.includes(techId)) {
nextArray = nextArray.filter((id) => !webTypes.includes(id));
} else if (techId.startsWith("native-")) {
nextArray = nextArray.filter((id) => !id.startsWith("native-"));
}
nextArray.push(techId);
}
if (nextArray.length > 1) {
nextArray = nextArray.filter((id) => id !== "none");
}
if (nextArray.length === 0) {
nextArray = ["none"];
}
} else {
if (isSelected) {
nextArray = nextArray.filter((id) => id !== techId);
} else {
nextArray.push(techId);
}
}
const uniqueNext = [...new Set(nextArray)].sort();
const uniqueCurrent = [...new Set(currentArray)].sort();
if (JSON.stringify(uniqueNext) !== JSON.stringify(uniqueCurrent)) {
update[catKey] = uniqueNext;
}
} else {
if (currentValue !== techId) {
update[catKey] = techId;
} else {
if (
(category === "git" ||
category === "install" ||
category === "auth") &&
techId === "false"
) {
update[catKey] = "true";
} else if (
(category === "git" ||
category === "install" ||
category === "auth") &&
techId === "true"
) {
update[catKey] = "false";
}
}
}
return Object.keys(update).length > 0 ? update : {};
});
};
const copyToClipboard = () => {
navigator.clipboard.writeText(command);
setCopied(true);
setTimeout(() => setCopied(false), 2000);
};
const resetStack = () => {
setStack(DEFAULT_STACK);
setShowHelp(false);
setShowPresets(false);
setActiveCategory(CATEGORY_ORDER[0]);
contentRef.current?.scrollTo(0, 0);
};
const saveCurrentStack = () => {
localStorage.setItem("betterTStackPreference", JSON.stringify(stack));
setLastSavedStack(stack);
toast.success("Your stack configuration has been saved");
};
const loadSavedStack = () => {
if (lastSavedStack) {
setStack(lastSavedStack);
setShowHelp(false);
setShowPresets(false);
setActiveCategory(CATEGORY_ORDER[0]);
contentRef.current?.scrollTo(0, 0);
toast.success("Saved configuration loaded");
}
};
const applyPreset = (presetId: string) => {
const preset = PRESET_TEMPLATES.find(
(template) => template.id === presetId,
);
if (preset) {
setStack(preset.stack);
setShowPresets(false);
setShowHelp(false);
setActiveCategory(CATEGORY_ORDER[0]);
contentRef.current?.scrollTo(0, 0);
toast.success(`Applied preset: ${preset.name}`);
}
};
const handleSidebarClick = (category: string) => {
setActiveCategory(category);
const element = sectionRefs.current[category];
if (element) {
element.scrollIntoView({
behavior: "smooth",
block: "start",
});
}
};
return (
<TooltipProvider>
<div
className={cn(
"flex h-screen flex-col overflow-hidden border-border bg-background text-foreground",
)}
>
<div
className={cn(
"grid w-full flex-shrink-0 grid-cols-2 items-center justify-center border-border border-b bg-background px-2 py-2 sm:grid-cols-3 sm:px-4",
)}
>
<Link href={"/"}>
<div className="mr-auto font-mono text-muted-foreground text-xs">
Home
</div>
</Link>
<div className="mx-auto hidden font-mono text-muted-foreground text-xs sm:block">
Create Better T Stack
</div>
<div className="ml-auto flex space-x-2">
<button
type="button"
onClick={() => setShowHelp((prev) => !prev)}
className={cn(
"text-muted-foreground transition-colors hover:text-foreground",
)}
title="Help"
>
<HelpCircle className="h-4 w-4" />
</button>
<button
type="button"
onClick={() => setShowPresets((prev) => !prev)}
className={cn(
"text-muted-foreground transition-colors hover:text-foreground",
)}
title="Presets"
>
<Star className="h-4 w-4" />
</button>
<Link
href={"https://github.com/AmanVarshney01/create-better-t-stack"}
target="_blank"
rel="noopener noreferrer"
className={cn(
"text-muted-foreground transition-colors hover:text-foreground",
)}
title="GitHub Repository"
>
<Github className="h-4 w-4" />
</Link>
<ThemeToggle />
</div>
</div>
{showHelp && (
<div className="flex-shrink-0 border-border border-b bg-background p-3 text-foreground sm:p-4">
<h3 className="mb-2 font-medium text-sm">
How to Use Stack Architect
</h3>
<ul className="list-disc space-y-1 pl-5 text-xs">
<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{" "}
<InfoIcon className="inline h-3 w-3" /> 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-border border-b bg-background p-3 sm:p-4">
<h3 className="mb-2 font-medium text-foreground text-sm">
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-border bg-background p-2 text-left transition-colors hover:bg-muted"
>
<div className="font-medium text-foreground text-sm">
{preset.name}
</div>
<div className="text-muted-foreground text-xs">
{preset.description}
</div>
</button>
))}
</div>
</div>
)}
<div className="flex-shrink-0 bg-background p-3 pb-0 font-mono sm:p-4 sm:pb-0">
<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-muted-foreground text-xs">
Project Name:
</span>
<input
type="text"
value={stack.projectName || ""}
onChange={(e) => {
const newValue = e.target.value;
setStack({ projectName: newValue });
}}
className={cn(
"w-full rounded border bg-background px-2 py-1 font-mono text-sm focus:outline-none sm:w-auto",
projectNameError
? "border-destructive bg-destructive/10 text-destructive-foreground"
: "border-border focus:border-primary",
)}
placeholder="my-better-t-app"
/>
{projectNameError && (
<p className="mt-1 text-destructive 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-border bg-background px-2 py-1 text-muted-foreground text-xs transition-colors hover:bg-muted"
title="Reset to defaults"
>
<RefreshCw className="h-3 w-3" />
Reset
</button>
<button
type="button"
onClick={getRandomStack}
className="flex items-center gap-1 rounded border border-border bg-background px-2 py-1 text-muted-foreground text-xs transition-colors hover:bg-muted"
title="Generate a random stack"
>
<Shuffle className="h-3 w-3" />
Random
</button>
{lastSavedStack && (
<button
type="button"
onClick={loadSavedStack}
className="flex items-center gap-1 rounded border border-border bg-background px-2 py-1 text-muted-foreground text-xs transition-colors hover:bg-muted"
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-border bg-background px-2 py-1 text-muted-foreground text-xs transition-colors hover:bg-muted"
title="Save current preferences"
>
<Star className="h-3 w-3" />
<span>Save</span>
</button>
<button
type="button"
onClick={shareToTwitter}
className="flex items-center gap-1 rounded border border-border bg-background px-2 py-1 text-muted-foreground text-xs transition-colors hover:bg-muted"
title="Share to Twitter"
>
<Share2 className="h-3 w-3" />
Share
</button>
</div>
</div>
<div className="relative mb-4 overflow-hidden rounded border border-border bg-background p-2 pr-16 sm:pr-20">
<div className="flex overflow-x-auto">
<span className="mr-2 select-none text-chart-4">$</span>
<code className="no-scrollbar inline-flex items-center overflow-x-auto whitespace-pre break-words text-muted-foreground text-xs sm:text-sm">
{command}
</code>
</div>
<button
type="button"
onClick={copyToClipboard}
className={cn(
"-translate-y-1/2 absolute top-1/2 right-1 flex items-center gap-1 rounded px-2 py-1 text-xs transition-colors",
copied
? "bg-muted text-chart-4"
: "text-muted-foreground hover:bg-muted hover:text-foreground",
)}
title={copied ? "Copied!" : "Copy command"}
>
{copied ? (
<>
<Check className="h-3 w-3 flex-shrink-0" />
<span>Copied</span>
</>
) : (
<>
<ClipboardCopy className="h-3 w-3 flex-shrink-0" />
<span>Copy</span>
</>
)}
</button>
</div>
<div className="mb-4">
<div className="flex flex-wrap gap-1.5">{selectedBadges}</div>
</div>
</div>
<div className="flex flex-grow overflow-hidden">
<nav className="hidden w-48 flex-shrink-0 overflow-y-auto border-border border-r p-2 md:flex">
<ul className="space-y-1">
{CATEGORY_ORDER.map((category) => (
<li key={category}>
<button
type="button"
onClick={() => handleSidebarClick(category)}
className={cn(
"flex w-full items-center justify-between rounded px-2 py-1.5 text-left font-mono text-xs transition-colors",
activeCategory === category
? "bg-primary/10 text-primary"
: "text-muted-foreground hover:bg-muted/50",
)}
>
<span>{getCategoryDisplayName(category)}</span>
{compatibilityAnalysis.notes[category]?.hasIssue && (
<span title="Compatibility issue affects this section">
<InfoIcon className="h-3 w-3 flex-shrink-0 text-chart-5" />{" "}
</span>
)}
</button>
</li>
))}
</ul>
</nav>
<ScrollArea ref={contentRef} className="flex-1 scroll-smooth">
<main className="flex-grow p-4">
{CATEGORY_ORDER.map((categoryKey) => {
const categoryOptions =
TECH_OPTIONS[categoryKey as keyof typeof TECH_OPTIONS] || [];
const categoryDisplayName = getCategoryDisplayName(categoryKey);
const filteredOptions = categoryOptions.filter(() => {
return true;
});
if (filteredOptions.length === 0) return null;
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-border border-b pb-2 text-muted-foreground">
<Terminal className="mr-2 h-5 w-5 flex-shrink-0" />
<h2 className="font-semibold text-base text-foreground">
{categoryDisplayName}
</h2>
{compatibilityAnalysis.notes[categoryKey]?.notes.length >
0 && (
<Tooltip delayDuration={100}>
<TooltipTrigger asChild>
<InfoIcon className="ml-2 h-4 w-4 flex-shrink-0 cursor-help text-muted-foreground" />
</TooltipTrigger>
<TooltipContent side="top" align="start">
<ul className="list-disc space-y-1 pl-4 text-xs">
{compatibilityAnalysis.notes[
categoryKey
].notes.map((note) => (
<li key={note}>{note}</li>
))}
</ul>
</TooltipContent>
</Tooltip>
)}
</div>
<div className="grid grid-cols-1 gap-3 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4">
{filteredOptions.map((tech) => {
let isSelected = false;
const category = categoryKey as keyof StackState;
const currentValue = stack[category];
if (
category === "addons" ||
category === "examples" ||
category === "frontend"
) {
isSelected = (
(currentValue as string[]) || []
).includes(tech.id);
} else {
isSelected = currentValue === tech.id;
}
const disabledReason = disabledReasons.get(
`${categoryKey}-${tech.id}`,
);
const isDisabled = !!disabledReason;
return (
<Tooltip key={tech.id} delayDuration={100}>
<TooltipTrigger asChild>
<motion.div
className={cn(
"relative rounded border p-3 transition-all",
isDisabled && !isSelected
? "cursor-not-allowed opacity-60"
: "cursor-pointer",
isSelected
? "border-primary bg-primary/10 ring-1 ring-primary"
: `border-border ${
!isDisabled
? "hover:border-muted hover:bg-muted"
: ""
}`,
)}
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-primary" />
) : (
<Circle className="h-5 w-5 text-muted-foreground" />
)}
</div>
<div className="flex-grow">
<div className="flex items-center justify-between">
<div className="flex items-center">
<TechIcon
icon={tech.icon}
name={tech.name}
className="mr-2 h-5 w-5"
/>
<span
className={cn(
"font-medium text-sm",
isSelected
? "text-primary"
: "text-foreground",
)}
>
{tech.name}
</span>
</div>
{isDisabled && !isSelected && (
<InfoIcon className="ml-2 h-4 w-4 flex-shrink-0 text-muted-foreground" />
)}
</div>
<p className="mt-1 text-muted-foreground text-xs">
{tech.description}
</p>
</div>
</div>
{tech.default && !isSelected && !isDisabled && (
<span className="absolute top-1 right-1 ml-2 flex-shrink-0 rounded bg-muted px-1 py-0.5 text-[10px] text-muted-foreground">
Default
</span>
)}
</motion.div>
</TooltipTrigger>
{isDisabled && disabledReason && (
<TooltipContent side="top" align="center">
<p>{disabledReason}</p>
</TooltipContent>
)}
</Tooltip>
);
})}
</div>
</section>
);
})}
<div className="h-10" />
</main>
</ScrollArea>
</div>
</div>
</TooltipProvider>
);
};
export default StackArchitect;