starter-structure-cli 0.2.1 → 0.2.2

package/templates/monorepo-turbo-pnpm/react-vite-api-express-mongoose/apps/web/src/hooks/auth/index.tsx

@@ -0,0 +1,28 @@
+import { useEffect, useState } from "react";
+
+type LoadState = "idle" | "loading" | "ready";
+
+export default function useAuth() {
+  const [state, setState] = useState<LoadState>("idle");
+  const [items, setItems] = useState<string[]>([]);
+
+  useEffect(() => {
+    setState("loading");
+
+    const timer = window.setTimeout(() => {
+      setItems([
+        "Auth starter task",
+        "Replace mock data",
+        "Connect real permissions"
+      ]);
+      setState("ready");
+    }, 120);
+
+    return () => window.clearTimeout(timer);
+  }, []);
+
+  return {
+    state,
+    items
+  };
+}

package/templates/monorepo-turbo-pnpm/react-vite-api-express-mongoose/apps/web/src/index.css

@@ -0,0 +1,47 @@
+@import "tailwindcss";
+
+:root {
+  color-scheme: light;
+  --canvas: #f4efe4;
+  --ink: #1f2937;
+  --muted: #6b7280;
+  --panel: rgba(255, 255, 255, 0.82);
+  --line: rgba(31, 41, 55, 0.12);
+  font-family: "Space Grotesk", "Segoe UI", sans-serif;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+html {
+  scroll-behavior: smooth;
+}
+
+button,
+input,
+textarea,
+select {
+  font: inherit;
+}
+
+#root {
+  min-height: 100vh;
+}
+
+
+body {
+  margin: 0;
+  min-width: 320px;
+  min-height: 100vh;
+  color: var(--ink);
+  background:
+    radial-gradient(circle at top left, rgba(240, 107, 70, 0.16), transparent 28%),
+    radial-gradient(circle at 85% 20%, rgba(22, 163, 74, 0.12), transparent 22%),
+    linear-gradient(180deg, #fcfaf5 0%, var(--canvas) 100%);
+}
+
+a {
+  color: inherit;
+  text-decoration: none;
+}

package/templates/monorepo-turbo-pnpm/react-vite-api-express-mongoose/apps/web/src/layout/dashboard/index.tsx

@@ -0,0 +1,24 @@
+import type { PropsWithChildren } from "react";
+
+type DashboardLayoutProps = PropsWithChildren<{
+  heading?: string;
+  summary?: string;
+}>;
+
+export default function DashboardLayout({
+  heading = "Dashboard Layout",
+  summary = "Starter layout wrapper for this workspace section.",
+  children
+}: DashboardLayoutProps) {
+  return (
+    <section className="min-h-screen bg-slate-50 px-6 py-8 text-slate-900">
+      <header className="mx-auto max-w-6xl rounded-3xl border border-slate-200 bg-white p-6 shadow-sm">
+        <p className="text-xs font-semibold uppercase tracking-[0.2em] text-slate-500">Layout</p>
+        <h1 className="mt-2 text-3xl font-semibold">{heading}</h1>
+        <p className="mt-2 max-w-2xl text-sm leading-6 text-slate-600">{summary}</p>
+      </header>
+
+      <div className="mx-auto mt-6 max-w-6xl">{children}</div>
+    </section>
+  );
+}

package/templates/monorepo-turbo-pnpm/react-vite-api-express-mongoose/apps/web/src/layout/main/index.tsx

@@ -0,0 +1,24 @@
+import type { PropsWithChildren } from "react";
+
+type MainLayoutProps = PropsWithChildren<{
+  heading?: string;
+  summary?: string;
+}>;
+
+export default function MainLayout({
+  heading = "Main Layout",
+  summary = "Starter layout wrapper for this workspace section.",
+  children
+}: MainLayoutProps) {
+  return (
+    <section className="min-h-screen bg-slate-50 px-6 py-8 text-slate-900">
+      <header className="mx-auto max-w-6xl rounded-3xl border border-slate-200 bg-white p-6 shadow-sm">
+        <p className="text-xs font-semibold uppercase tracking-[0.2em] text-slate-500">Layout</p>
+        <h1 className="mt-2 text-3xl font-semibold">{heading}</h1>
+        <p className="mt-2 max-w-2xl text-sm leading-6 text-slate-600">{summary}</p>
+      </header>
+
+      <div className="mx-auto mt-6 max-w-6xl">{children}</div>
+    </section>
+  );
+}

package/templates/monorepo-turbo-pnpm/react-vite-api-express-mongoose/apps/web/src/lib/utils/index.tsx

@@ -0,0 +1,13 @@
+export function toUtilsSlug(value: string) {
+  return value
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-|-$/g, "");
+}
+
+export function formatUtilsLabel(value: string) {
+  return value
+    .replace(/[-_]+/g, " ")
+    .replace(/\b\w/g, (character) => character.toUpperCase());
+}

package/templates/monorepo-turbo-pnpm/react-vite-api-express-mongoose/apps/web/src/main.jsx

@@ -0,0 +1,11 @@
+import { StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+
+import App from "./App";
+import "./index.css";
+
+createRoot(document.getElementById("root")).render(
+  <StrictMode>
+    <App />
+  </StrictMode>
+);

package/templates/monorepo-turbo-pnpm/react-vite-api-express-mongoose/apps/web/src/routes/admin/index.tsx

@@ -0,0 +1,24 @@
+export type StarterRoute = {
+  path: string;
+  label: string;
+  permission?: string;
+};
+
+export const adminRoutes: StarterRoute[] = [
+  {
+    path: "/admin",
+    label: "Admin Home"
+  },
+  {
+    path: "/admin/create",
+    label: "Admin Create",
+    permission: "admin.create"
+  },
+  {
+    path: "/admin/view/:id",
+    label: "Admin Detail",
+    permission: "admin.read"
+  }
+];
+
+export default adminRoutes;

package/templates/monorepo-turbo-pnpm/react-vite-api-express-mongoose/apps/web/src/routes/auth/index.tsx

@@ -0,0 +1,24 @@
+export type StarterRoute = {
+  path: string;
+  label: string;
+  permission?: string;
+};
+
+export const authRoutes: StarterRoute[] = [
+  {
+    path: "/auth",
+    label: "Auth Home"
+  },
+  {
+    path: "/auth/create",
+    label: "Auth Create",
+    permission: "auth.create"
+  },
+  {
+    path: "/auth/view/:id",
+    label: "Auth Detail",
+    permission: "auth.read"
+  }
+];
+
+export default authRoutes;

package/templates/monorepo-turbo-pnpm/react-vite-api-express-mongoose/apps/web/src/routes/guide/index.tsx

@@ -0,0 +1,24 @@
+export type StarterRoute = {
+  path: string;
+  label: string;
+  permission?: string;
+};
+
+export const guideRoutes: StarterRoute[] = [
+  {
+    path: "/guide",
+    label: "Guide Home"
+  },
+  {
+    path: "/guide/create",
+    label: "Guide Create",
+    permission: "guide.create"
+  },
+  {
+    path: "/guide/view/:id",
+    label: "Guide Detail",
+    permission: "guide.read"
+  }
+];
+
+export default guideRoutes;

package/templates/monorepo-turbo-pnpm/react-vite-api-express-mongoose/apps/web/src/routes/user/index.tsx

@@ -0,0 +1,24 @@
+export type StarterRoute = {
+  path: string;
+  label: string;
+  permission?: string;
+};
+
+export const userRoutes: StarterRoute[] = [
+  {
+    path: "/user",
+    label: "User Home"
+  },
+  {
+    path: "/user/create",
+    label: "User Create",
+    permission: "user.create"
+  },
+  {
+    path: "/user/view/:id",
+    label: "User Detail",
+    permission: "user.read"
+  }
+];
+
+export default userRoutes;

package/templates/monorepo-turbo-pnpm/react-vite-api-express-mongoose/apps/web/src/types/env/index.tsx

@@ -0,0 +1,13 @@
+export type EnvStatus = "draft" | "active" | "archived";
+
+export interface EnvRecord {
+  id: string;
+  title: string;
+  description: string;
+  status: EnvStatus;
+}
+
+export interface EnvFilter {
+  search?: string;
+  status?: EnvStatus;
+}

package/templates/monorepo-turbo-pnpm/react-vite-api-express-mongoose/apps/web/src/view/admin/index.tsx

@@ -0,0 +1,29 @@
+const tasks = [
+  "Connect the page to real data",
+  "Replace starter metrics",
+  "Hook up page-specific actions"
+];
+
+export default function AdminPage() {
+  return (
+    <main className="space-y-6">
+      <section className="rounded-3xl border border-slate-200 bg-white p-6 shadow-sm">
+        <p className="text-xs font-semibold uppercase tracking-[0.24em] text-slate-500">
+          Admin
+        </p>
+        <h1 className="mt-2 text-3xl font-semibold text-slate-900">Admin Page</h1>
+        <p className="mt-3 max-w-2xl text-sm leading-6 text-slate-600">
+          Use this starter page as the first real implementation for the admin section.
+        </p>
+      </section>
+
+      <section className="grid gap-4 md:grid-cols-3">
+        {tasks.map((task) => (
+          <article key={task} className="rounded-2xl bg-slate-50 px-4 py-5 text-sm text-slate-700">
+            {task}
+          </article>
+        ))}
+      </section>
+    </main>
+  );
+}

package/templates/monorepo-turbo-pnpm/react-vite-api-express-mongoose/apps/web/src/view/all/index.tsx

@@ -0,0 +1,29 @@
+const tasks = [
+  "Connect the page to real data",
+  "Replace starter metrics",
+  "Hook up page-specific actions"
+];
+
+export default function AllPage() {
+  return (
+    <main className="space-y-6">
+      <section className="rounded-3xl border border-slate-200 bg-white p-6 shadow-sm">
+        <p className="text-xs font-semibold uppercase tracking-[0.24em] text-slate-500">
+          All
+        </p>
+        <h1 className="mt-2 text-3xl font-semibold text-slate-900">All Page</h1>
+        <p className="mt-3 max-w-2xl text-sm leading-6 text-slate-600">
+          Use this starter page as the first real implementation for the all section.
+        </p>
+      </section>
+
+      <section className="grid gap-4 md:grid-cols-3">
+        {tasks.map((task) => (
+          <article key={task} className="rounded-2xl bg-slate-50 px-4 py-5 text-sm text-slate-700">
+            {task}
+          </article>
+        ))}
+      </section>
+    </main>
+  );
+}

package/templates/monorepo-turbo-pnpm/react-vite-api-express-mongoose/apps/web/src/view/auth/index.tsx

@@ -0,0 +1,29 @@
+const tasks = [
+  "Connect the page to real data",
+  "Replace starter metrics",
+  "Hook up page-specific actions"
+];
+
+export default function AuthPage() {
+  return (
+    <main className="space-y-6">
+      <section className="rounded-3xl border border-slate-200 bg-white p-6 shadow-sm">
+        <p className="text-xs font-semibold uppercase tracking-[0.24em] text-slate-500">
+          Auth
+        </p>
+        <h1 className="mt-2 text-3xl font-semibold text-slate-900">Auth Page</h1>
+        <p className="mt-3 max-w-2xl text-sm leading-6 text-slate-600">
+          Use this starter page as the first real implementation for the auth section.
+        </p>
+      </section>
+
+      <section className="grid gap-4 md:grid-cols-3">
+        {tasks.map((task) => (
+          <article key={task} className="rounded-2xl bg-slate-50 px-4 py-5 text-sm text-slate-700">
+            {task}
+          </article>
+        ))}
+      </section>
+    </main>
+  );
+}

package/templates/monorepo-turbo-pnpm/react-vite-api-express-mongoose/apps/web/src/view/guide/index.tsx

@@ -0,0 +1,29 @@
+const tasks = [
+  "Connect the page to real data",
+  "Replace starter metrics",
+  "Hook up page-specific actions"
+];
+
+export default function GuidePage() {
+  return (
+    <main className="space-y-6">
+      <section className="rounded-3xl border border-slate-200 bg-white p-6 shadow-sm">
+        <p className="text-xs font-semibold uppercase tracking-[0.24em] text-slate-500">
+          Guide
+        </p>
+        <h1 className="mt-2 text-3xl font-semibold text-slate-900">Guide Page</h1>
+        <p className="mt-3 max-w-2xl text-sm leading-6 text-slate-600">
+          Use this starter page as the first real implementation for the guide section.
+        </p>
+      </section>
+
+      <section className="grid gap-4 md:grid-cols-3">
+        {tasks.map((task) => (
+          <article key={task} className="rounded-2xl bg-slate-50 px-4 py-5 text-sm text-slate-700">
+            {task}
+          </article>
+        ))}
+      </section>
+    </main>
+  );
+}

package/templates/monorepo-turbo-pnpm/react-vite-api-express-mongoose/apps/web/src/view/user/index.tsx

@@ -0,0 +1,29 @@
+const tasks = [
+  "Connect the page to real data",
+  "Replace starter metrics",
+  "Hook up page-specific actions"
+];
+
+export default function UserPage() {
+  return (
+    <main className="space-y-6">
+      <section className="rounded-3xl border border-slate-200 bg-white p-6 shadow-sm">
+        <p className="text-xs font-semibold uppercase tracking-[0.24em] text-slate-500">
+          User
+        </p>
+        <h1 className="mt-2 text-3xl font-semibold text-slate-900">User Page</h1>
+        <p className="mt-3 max-w-2xl text-sm leading-6 text-slate-600">
+          Use this starter page as the first real implementation for the user section.
+        </p>
+      </section>
+
+      <section className="grid gap-4 md:grid-cols-3">
+        {tasks.map((task) => (
+          <article key={task} className="rounded-2xl bg-slate-50 px-4 py-5 text-sm text-slate-700">
+            {task}
+          </article>
+        ))}
+      </section>
+    </main>
+  );
+}

package/templates/monorepo-turbo-pnpm/react-vite-api-express-mongoose/apps/web/vite.config.js

@@ -0,0 +1,7 @@
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import tailwindcss from "@tailwindcss/vite";
+
+export default defineConfig({
+  plugins: [react(), tailwindcss()]
+});

package/templates/monorepo-turbo-pnpm/react-vite-api-express-mongoose/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "__APP_NAME__",
+  "private": true,
+  "packageManager": "pnpm@10.6.0",
+  "scripts": {
+    "dev": "turbo run dev --parallel",
+    "build": "turbo run build",
+    "lint": "turbo run lint"
+  },
+  "devDependencies": {
+    "turbo": "^2.5.6"
+  }
+}

package/templates/monorepo-turbo-pnpm/react-vite-api-express-mongoose/pnpm-workspace.yaml

@@ -0,0 +1,2 @@
+packages:
+  - "apps/*"

package/templates/monorepo-turbo-pnpm/react-vite-api-express-mongoose/turbo.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://turbo.build/schema.json",
+  "tasks": {
+    "build": {
+      "dependsOn": [
+        "^build"
+      ],
+      "outputs": [
+        "dist/**",
+        ".next/**"
+      ]
+    },
+    "dev": {
+      "cache": false,
+      "persistent": true
+    },
+    "lint": {
+      "outputs": []
+    }
+  }
+}

package/templates/single/nextjs-tailwind/.env.example

@@ -0,0 +1,2 @@
+NEXT_PUBLIC_APP_NAME=__APP_NAME__
+NEXT_PUBLIC_APP_URL=http://localhost:3000

package/templates/single/nextjs-tailwind/README.md

@@ -0,0 +1,35 @@
+# __APP_NAME__
+
+Next.js App Router starter with Tailwind CSS v4.
+
+## Features
+
+- Next.js App Router
+- Tailwind CSS v4
+- ESLint flat config
+- Reusable landing page sections
+- Alias support with `@/*`
+
+## Project structure
+
+```text
+.
+├── app/
+├── components/
+├── lib/
+├── public/
+├── .env.example
+├── eslint.config.mjs
+├── jsconfig.json
+├── next.config.mjs
+├── package.json
+└── postcss.config.mjs
+```
+
+## Getting started
+
+```bash
+npm install
+cp .env.example .env
+npm run dev
+```

package/templates/single/nextjs-tailwind/app/globals.css

@@ -0,0 +1,56 @@
+@import "tailwindcss";
+
+:root {
+  --color-ink: #07111d;
+  --color-panel: rgba(13, 24, 44, 0.76);
+  --color-paper: #eef5ff;
+  --color-muted: #9db6d5;
+  --color-line: rgba(173, 201, 232, 0.18);
+  --color-accent: #8bf2cc;
+  --color-accent-strong: #2be0a5;
+  --color-sun: #ffd36e;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+html {
+  scroll-behavior: smooth;
+}
+
+body {
+  margin: 0;
+  min-height: 100vh;
+  background:
+    radial-gradient(circle at top left, rgba(139, 242, 204, 0.12), transparent 28%),
+    radial-gradient(circle at 78% 18%, rgba(255, 211, 110, 0.14), transparent 26%),
+    linear-gradient(180deg, #06101c 0%, #07111d 48%, #0b1627 100%);
+  color: var(--color-paper);
+  font-family: var(--font-body), sans-serif;
+}
+
+a {
+  color: inherit;
+  text-decoration: none;
+}
+
+button {
+  font: inherit;
+}
+
+.shell {
+  width: min(1120px, calc(100% - 2rem));
+  margin: 0 auto;
+}
+
+.card-grid {
+  display: grid;
+  gap: 1.25rem;
+}
+
+@media (min-width: 768px) {
+  .card-grid {
+    grid-template-columns: repeat(3, minmax(0, 1fr));
+  }
+}

package/templates/single/nextjs-tailwind/app/layout.js

@@ -0,0 +1,28 @@
+import { Geist, Space_Grotesk } from "next/font/google";
+
+import "./globals.css";
+
+const bodyFont = Geist({
+  variable: "--font-body",
+  subsets: ["latin"]
+});
+
+const displayFont = Space_Grotesk({
+  variable: "--font-display",
+  subsets: ["latin"]
+});
+
+export const metadata = {
+  title: "__APP_NAME__",
+  description: "A Next.js and Tailwind CSS starter for fast product launches."
+};
+
+export default function RootLayout({ children }) {
+  return (
+    <html lang="en">
+      <body className={`${bodyFont.variable} ${displayFont.variable}`}>
+        {children}
+      </body>
+    </html>
+  );
+}

package/templates/single/nextjs-tailwind/app/page.js

@@ -0,0 +1,15 @@
+import { CalloutStrip } from "@/components/home/callout-strip";
+import { FeatureGrid } from "@/components/home/feature-grid";
+import { HeroSection } from "@/components/home/hero-section";
+import { SiteHeader } from "@/components/site-header";
+
+export default function HomePage() {
+  return (
+    <main className="min-h-screen bg-[var(--color-ink)] text-[var(--color-paper)]">
+      <SiteHeader />
+      <HeroSection />
+      <FeatureGrid />
+      <CalloutStrip />
+    </main>
+  );
+}

package/templates/single/nextjs-tailwind/components/home/callout-strip/index.js

@@ -0,0 +1,22 @@
+export function CalloutStrip() {
+  return (
+    <section className="py-16 md:py-24" id="cta">
+      <div className="shell">
+        <div className="overflow-hidden rounded-[2rem] border border-[var(--color-line)] bg-[linear-gradient(135deg,_rgba(139,242,204,0.12),_rgba(255,211,110,0.08)_55%,_rgba(255,255,255,0.03))] p-8 md:p-12">
+          <div className="max-w-3xl space-y-5">
+            <p className="text-sm uppercase tracking-[0.28em] text-[var(--color-sun)]">
+              Ready to adapt
+            </p>
+            <h2 className="font-[family-name:var(--font-display)] text-3xl font-semibold text-white md:text-5xl">
+              Swap the copy, adjust the palette, and ship a branded landing page in one sprint.
+            </h2>
+            <p className="max-w-2xl text-base leading-7 text-[var(--color-muted)] md:text-lg">
+              This starter is intentionally small, fast, and easy to reshape into a SaaS homepage,
+              agency site, product launch page, or internal marketing shell.
+            </p>
+          </div>
+        </div>
+      </div>
+    </section>
+  );
+}

package/templates/single/nextjs-tailwind/components/home/feature-grid/index.js

@@ -0,0 +1,33 @@
+import { siteConfig } from "@/lib/site-config";
+
+export function FeatureGrid() {
+  return (
+    <section className="py-8 md:py-12" id="features">
+      <div className="shell">
+        <div className="max-w-2xl space-y-4">
+          <p className="text-sm uppercase tracking-[0.28em] text-[var(--color-accent)]">
+            Why this starter
+          </p>
+          <h2 className="font-[family-name:var(--font-display)] text-3xl font-semibold text-white md:text-5xl">
+            A clean structure you can extend without rewriting the basics.
+          </h2>
+        </div>
+
+        <div className="card-grid mt-10">
+          {siteConfig.features.map((feature) => (
+            <article
+              className="rounded-[1.75rem] border border-[var(--color-line)] bg-[var(--color-panel)] p-6"
+              key={feature.title}
+            >
+              <div className="mb-5 inline-flex rounded-2xl bg-[rgba(139,242,204,0.12)] px-4 py-2 text-xs font-semibold uppercase tracking-[0.24em] text-[var(--color-accent)]">
+                {feature.tag}
+              </div>
+              <h3 className="text-xl font-semibold text-white">{feature.title}</h3>
+              <p className="mt-3 text-sm leading-7 text-[var(--color-muted)]">{feature.copy}</p>
+            </article>
+          ))}
+        </div>
+      </div>
+    </section>
+  );
+}