mirror of
https://github.com/FranP-code/create-better-t-stack.git
synced 2025-10-12 23:52:15 +00:00
1161 lines
37 KiB
TypeScript
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;
|