starter-structure-cli 0.2.0 → 0.2.2

package/templates/monorepo-turbo-pnpm/nextjs-api-express-prisma/apps/web/src/context/index.tsx

@@ -0,0 +1,28 @@
+import { createContext, useContext, useState, type PropsWithChildren } from "react";
+
+type ContextState = {
+  activeSection: string;
+  setActiveSection: (value: string) => void;
+};
+
+const ContextContext = createContext<ContextState | undefined>(undefined);
+
+export function ContextProvider({ children }: PropsWithChildren) {
+  const [activeSection, setActiveSection] = useState("dashboard");
+
+  return (
+    <ContextContext.Provider value={{ activeSection, setActiveSection }}>
+      {children}
+    </ContextContext.Provider>
+  );
+}
+
+export function useContext() {
+  const context = useContext(ContextContext);
+
+  if (!context) {
+    throw new Error("useContext must be used inside ContextProvider.");
+  }
+
+  return context;
+}

package/templates/monorepo-turbo-pnpm/nextjs-api-express-prisma/apps/web/src/data/menu-items/index.tsx

@@ -0,0 +1,7 @@
+export const menuItems = [
+  { id: "dashboard", label: "Dashboard", href: "/dashboard" },
+  { id: "reports", label: "Reports", href: "/reports" },
+  { id: "settings", label: "Settings", href: "/settings" }
+];
+
+export default menuItems;

package/templates/monorepo-turbo-pnpm/nextjs-api-express-prisma/apps/web/src/hooks/api/index.tsx

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

package/templates/monorepo-turbo-pnpm/nextjs-api-express-prisma/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/nextjs-api-express-prisma/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/nextjs-api-express-prisma/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/nextjs-api-express-prisma/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/nextjs-api-express-prisma/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/nextjs-api-express-prisma/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/nextjs-api-express-prisma/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/nextjs-api-express-prisma/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/nextjs-api-express-prisma/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/nextjs-api-express-prisma/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/nextjs-api-express-prisma/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/nextjs-api-express-prisma/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/nextjs-api-express-prisma/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/nextjs-api-express-prisma/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/nextjs-api-express-prisma/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/nextjs-api-express-prisma/pnpm-workspace.yaml

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

package/templates/monorepo-turbo-pnpm/nextjs-api-express-prisma/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/monorepo-turbo-pnpm/nextjs-api-nestjs-prisma/.env.example

@@ -0,0 +1,10 @@
+# web
+VITE_APP_NAME=__APP_NAME__
+VITE_API_URL=http://localhost:5000/api
+
+# api
+PORT=5000
+CLIENT_URL=http://localhost:5173
+JWT_SECRET=replace-me
+DATABASE_URL=mysql://root:password@localhost:3306/__APP_NAME__
+MONGODB_URI=mongodb://127.0.0.1:27017/__APP_NAME__

package/templates/monorepo-turbo-pnpm/nextjs-api-nestjs-prisma/README.md

@@ -0,0 +1,18 @@
+# __APP_NAME__
+
+Turbo + pnpm monorepo starter with separate web and API apps.
+
+## Workspace apps
+
+- `apps/web`: frontend app
+- `apps/api`: backend API
+
+## Getting started
+
+```bash
+pnpm install
+cp .env.example .env
+pnpm dev
+```
+
+Prisma-based variants default to MySQL in the copied API app. Change the provider and `DATABASE_URL` if you want a different database.

package/templates/monorepo-turbo-pnpm/nextjs-api-nestjs-prisma/apps/api/controllers/booking/index.tsx

@@ -0,0 +1,35 @@
+export type StarterRequest = {
+  params?: Record<string, string>;
+  query?: Record<string, string>;
+  body?: Record<string, unknown>;
+  user?: {
+    id: string;
+    role: string;
+  };
+};
+
+export type StarterResponse = {
+  statusCode: number;
+  body: Record<string, unknown>;
+};
+
+export async function listBooking(request: StarterRequest): Promise<StarterResponse> {
+  return {
+    statusCode: 200,
+    body: {
+      feature: "booking",
+      filters: request.query ?? {},
+      items: []
+    }
+  };
+}
+
+export async function createBooking(request: StarterRequest): Promise<StarterResponse> {
+  return {
+    statusCode: 201,
+    body: {
+      feature: "booking",
+      payload: request.body ?? {}
+    }
+  };
+}

package/templates/monorepo-turbo-pnpm/nextjs-api-nestjs-prisma/apps/api/controllers/category/index.tsx

@@ -0,0 +1,35 @@
+export type StarterRequest = {
+  params?: Record<string, string>;
+  query?: Record<string, string>;
+  body?: Record<string, unknown>;
+  user?: {
+    id: string;
+    role: string;
+  };
+};
+
+export type StarterResponse = {
+  statusCode: number;
+  body: Record<string, unknown>;
+};
+
+export async function listCategory(request: StarterRequest): Promise<StarterResponse> {
+  return {
+    statusCode: 200,
+    body: {
+      feature: "category",
+      filters: request.query ?? {},
+      items: []
+    }
+  };
+}
+
+export async function createCategory(request: StarterRequest): Promise<StarterResponse> {
+  return {
+    statusCode: 201,
+    body: {
+      feature: "category",
+      payload: request.body ?? {}
+    }
+  };
+}

package/templates/monorepo-turbo-pnpm/nextjs-api-nestjs-prisma/apps/api/controllers/contact/index.tsx

@@ -0,0 +1,35 @@
+export type StarterRequest = {
+  params?: Record<string, string>;
+  query?: Record<string, string>;
+  body?: Record<string, unknown>;
+  user?: {
+    id: string;
+    role: string;
+  };
+};
+
+export type StarterResponse = {
+  statusCode: number;
+  body: Record<string, unknown>;
+};
+
+export async function listContact(request: StarterRequest): Promise<StarterResponse> {
+  return {
+    statusCode: 200,
+    body: {
+      feature: "contact",
+      filters: request.query ?? {},
+      items: []
+    }
+  };
+}
+
+export async function createContact(request: StarterRequest): Promise<StarterResponse> {
+  return {
+    statusCode: 201,
+    body: {
+      feature: "contact",
+      payload: request.body ?? {}
+    }
+  };
+}

package/templates/monorepo-turbo-pnpm/nextjs-api-nestjs-prisma/apps/api/controllers/story/index.tsx

@@ -0,0 +1,35 @@
+export type StarterRequest = {
+  params?: Record<string, string>;
+  query?: Record<string, string>;
+  body?: Record<string, unknown>;
+  user?: {
+    id: string;
+    role: string;
+  };
+};
+
+export type StarterResponse = {
+  statusCode: number;
+  body: Record<string, unknown>;
+};
+
+export async function listStory(request: StarterRequest): Promise<StarterResponse> {
+  return {
+    statusCode: 200,
+    body: {
+      feature: "story",
+      filters: request.query ?? {},
+      items: []
+    }
+  };
+}
+
+export async function createStory(request: StarterRequest): Promise<StarterResponse> {
+  return {
+    statusCode: 201,
+    body: {
+      feature: "story",
+      payload: request.body ?? {}
+    }
+  };
+}

package/templates/monorepo-turbo-pnpm/nextjs-api-nestjs-prisma/apps/api/middleware/admin/index.tsx

@@ -0,0 +1,20 @@
+export type AccessContext = {
+  role?: string;
+  permissions?: string[];
+};
+
+export function requireAdmin(context: AccessContext) {
+  if (!context.role) {
+    return {
+      allowed: false,
+      reason: "Missing authenticated role."
+    };
+  }
+
+  return {
+    allowed: true,
+    reason: "Admin access granted."
+  };
+}
+
+export default requireAdmin;