leedstack 3.1.0

package/tools/templates/db/postgres/backend/node-express/backend/prisma/schema.prisma.ejs

@@ -0,0 +1,39 @@
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+}
+
+model User {
+  id        BigInt   @id @default(autoincrement())
+  email     String   @unique @db.VarChar(255)
+  name      String?  @db.VarChar(120)
+  createdAt DateTime @default(now()) @map("created_at") @db.Timestamptz
+
+  roles UserRole[]
+
+  @@map("users")
+}
+
+model Role {
+  id    Int    @id @default(autoincrement())
+  name  String @unique @db.VarChar(30)
+
+  users UserRole[]
+
+  @@map("roles")
+}
+
+model UserRole {
+  userId BigInt @map("user_id")
+  roleId Int    @map("role_id")
+
+  user User @relation(fields: [userId], references: [id], onDelete: Cascade)
+  role Role @relation(fields: [roleId], references: [id], onDelete: Cascade)
+
+  @@id([userId, roleId])
+  @@map("user_roles")
+}

package/tools/templates/frontend/angular/frontend/.env.example

@@ -0,0 +1,9 @@
+NG_APP_API_BASE=http://localhost:8080
+<% if (modules.auth) { -%>
+NG_APP_AUTH0_DOMAIN=your-tenant.us.auth0.com
+NG_APP_AUTH0_CLIENT_ID=your_spa_client_id
+NG_APP_AUTH0_AUDIENCE=https://api.<%= appSlug %>
+<% } -%>
+<% if (modules.payments) { -%>
+NG_APP_STRIPE_PUBLISHABLE_KEY=pk_test_xxx
+<% } -%>

package/tools/templates/frontend/angular/frontend/angular.json

@@ -0,0 +1,66 @@
+{
+  "$schema": "./node_modules/@angular/cli/lib/config/schema.json",
+  "version": 1,
+  "newProjectRoot": "projects",
+  "projects": {
+    "<%= appSlug %>-frontend": {
+      "projectType": "application",
+      "schematics": {
+        "@schematics/angular:component": {
+          "standalone": true
+        }
+      },
+      "root": "",
+      "sourceRoot": "src",
+      "prefix": "app",
+      "architect": {
+        "build": {
+          "builder": "@angular-devkit/build-angular:application",
+          "options": {
+            "outputPath": "dist",
+            "index": "src/index.html",
+            "browser": "src/main.ts",
+            "polyfills": ["zone.js"],
+            "tsConfig": "tsconfig.app.json",
+            "assets": ["src/favicon.ico", "src/assets"],
+            "styles": ["src/styles.css"],
+            "scripts": []
+          },
+          "configurations": {
+            "production": {
+              "budgets": [
+                {
+                  "type": "initial",
+                  "maximumWarning": "500kb",
+                  "maximumError": "1mb"
+                }
+              ],
+              "outputHashing": "all"
+            },
+            "development": {
+              "optimization": false,
+              "extractLicenses": false,
+              "sourceMap": true
+            }
+          },
+          "defaultConfiguration": "production"
+        },
+        "serve": {
+          "builder": "@angular-devkit/build-angular:dev-server",
+          "configurations": {
+            "production": {
+              "buildTarget": "<%= appSlug %>-frontend:build:production"
+            },
+            "development": {
+              "buildTarget": "<%= appSlug %>-frontend:build:development"
+            }
+          },
+          "defaultConfiguration": "development",
+          "options": {
+            "port": 5173
+          }
+        }
+      }
+    }
+  }
+}

package/tools/templates/frontend/angular/frontend/package.json.ejs

@@ -0,0 +1,31 @@
+{
+  "name": "<%= appSlug %>-frontend",
+  "version": "0.0.1",
+  "private": true,
+  "scripts": {
+    "dev": "ng serve",
+    "build": "ng build",
+    "watch": "ng build --watch --configuration development",
+    "test": "ng test"
+  },
+  "dependencies": {
+    "@angular/animations": "^19.0.0",
+    "@angular/common": "^19.0.0",
+    "@angular/compiler": "^19.0.0",
+    "@angular/core": "^19.0.0",
+    "@angular/forms": "^19.0.0",
+    "@angular/platform-browser": "^19.0.0",
+    "@angular/platform-browser-dynamic": "^19.0.0",
+    "@angular/router": "^19.0.0",
+    "@auth0/auth0-spa-js": "^2.1.3",
+    "rxjs": "^7.8.1",
+    "tslib": "^2.7.0",
+    "zone.js": "^0.15.0"
+  },
+  "devDependencies": {
+    "@angular-devkit/build-angular": "^19.0.0",
+    "@angular/cli": "^19.0.0",
+    "@angular/compiler-cli": "^19.0.0",
+    "typescript": "~5.6.3"
+  }
+}

package/tools/templates/frontend/angular/frontend/src/app/app.component.ts

@@ -0,0 +1,30 @@
+import { Component } from '@angular/core';
+import { RouterOutlet, RouterLink } from '@angular/router';
+
+@Component({
+  selector: 'app-root',
+  standalone: true,
+  imports: [RouterOutlet, RouterLink],
+  template: `
+    <div class="app">
+      <nav>
+        <a routerLink="/">Home</a>
+<% if (modules.contact) { -%>
+        <a routerLink="/contact">Contact</a>
+<% } -%>
+<% if (modules.auth) { -%>
+        <a routerLink="/login">Login</a>
+<% } -%>
+<% if (modules.admin) { -%>
+        <a routerLink="/dashboard">Dashboard</a>
+<% } -%>
+      </nav>
+      <main>
+        <router-outlet />
+      </main>
+    </div>
+  `
+})
+export class AppComponent {
+  title = '<%= appName %>';
+}

package/tools/templates/frontend/angular/frontend/src/app/app.routes.ts

@@ -0,0 +1,18 @@
+import { Routes } from '@angular/router';
+import { HomeComponent } from './components/home.component';
+<% if (modules.contact) { -%>
+import { ContactComponent } from './components/contact.component';
+<% } -%>
+<% if (modules.admin) { -%>
+import { DashboardComponent } from './components/dashboard.component';
+<% } -%>
+
+export const routes: Routes = [
+  { path: '', component: HomeComponent },
+<% if (modules.contact) { -%>
+  { path: 'contact', component: ContactComponent },
+<% } -%>
+<% if (modules.admin) { -%>
+  { path: 'dashboard', component: DashboardComponent },
+<% } -%>
+];

package/tools/templates/frontend/angular/frontend/src/app/components/home.component.ts

@@ -0,0 +1,24 @@
+import { Component } from '@angular/core';
+
+@Component({
+  selector: 'app-home',
+  standalone: true,
+  template: `
+    <div>
+      <h1>Welcome to <%= AppName %></h1>
+      <p>This is a full-stack application built with:</p>
+      <ul>
+        <li>Frontend: <%= frontend %></li>
+        <li>Backend: <%= backend %></li>
+        <li>Database: <%= db %></li>
+<% if (modules.auth) { -%>
+        <li>Auth: <%= auth %></li>
+<% } -%>
+<% if (modules.payments) { -%>
+        <li>Payments: <%= payments %></li>
+<% } -%>
+      </ul>
+    </div>
+  `
+})
+export class HomeComponent {}

package/tools/templates/frontend/angular/frontend/src/app/services/api.service.ts

@@ -0,0 +1,48 @@
+import { Injectable } from '@angular/core';
+
+@Injectable({
+  providedIn: 'root'
+})
+export class ApiService {
+  private readonly apiBase = 'http://localhost:8080'; // Configure via environment
+
+  /**
+   * Fetch wrapper that automatically adds API base URL
+   */
+  async fetch<T = any>(endpoint: string, options: RequestInit = {}): Promise<T> {
+    const url = `${this.apiBase}${endpoint}`;
+
+    const config: RequestInit = {
+      ...options,
+      headers: {
+        'Content-Type': 'application/json',
+        ...options.headers,
+      },
+    };
+
+    const response = await fetch(url, config);
+
+    if (!response.ok) {
+      throw new Error(`API Error: ${response.statusText}`);
+    }
+
+    return response.json();
+  }
+
+  /**
+   * Example usage in components:
+   *
+   * constructor(private api: ApiService) {}
+   *
+   * async ngOnInit() {
+   *   // GET request
+   *   const data = await this.api.fetch('/api/example');
+   *
+   *   // POST request
+   *   const result = await this.api.fetch('/api/contact', {
+   *     method: 'POST',
+   *     body: JSON.stringify({ name: 'John', email: 'john@example.com' })
+   *   });
+   * }
+   */
+}

package/tools/templates/frontend/angular/frontend/src/favicon.ico

@@ -0,0 +1 @@
+<!-- Placeholder favicon -->

package/tools/templates/frontend/angular/frontend/src/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <title><%= AppName %></title>
+  <base href="/">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <link rel="icon" type="image/x-icon" href="favicon.ico">
+</head>
+<body>
+  <app-root></app-root>
+</body>
+</html>

package/tools/templates/frontend/angular/frontend/src/main.ts

@@ -0,0 +1,10 @@
+import { bootstrapApplication } from '@angular/platform-browser';
+import { provideRouter } from '@angular/router';
+import { AppComponent } from './app/app.component';
+import { routes } from './app/app.routes';
+
+bootstrapApplication(AppComponent, {
+  providers: [
+    provideRouter(routes)
+  ]
+}).catch(err => console.error(err));

package/tools/templates/frontend/angular/frontend/src/styles.css

@@ -0,0 +1,31 @@
+body {
+  margin: 0;
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
+}
+
+.app {
+  display: flex;
+  flex-direction: column;
+  min-height: 100vh;
+}
+
+nav {
+  display: flex;
+  gap: 1rem;
+  padding: 1rem;
+  background: #f0f0f0;
+}
+
+nav a {
+  text-decoration: none;
+  color: #333;
+}
+
+nav a:hover {
+  text-decoration: underline;
+}
+
+main {
+  flex: 1;
+  padding: 2rem;
+}

package/tools/templates/frontend/angular/frontend/tsconfig.app.json

@@ -0,0 +1,9 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./out-tsc/app",
+    "types": []
+  },
+  "files": ["src/main.ts"],
+  "include": ["src/**/*.d.ts"]
+}

package/tools/templates/frontend/angular/frontend/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compileOnSave": false,
+  "compilerOptions": {
+    "outDir": "./dist/out-tsc",
+    "strict": true,
+    "noImplicitOverride": true,
+    "noPropertyAccessFromIndexSignature": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "sourceMap": true,
+    "declaration": false,
+    "experimentalDecorators": true,
+    "moduleResolution": "bundler",
+    "importHelpers": true,
+    "target": "ES2022",
+    "module": "ES2022",
+    "lib": ["ES2022", "dom"]
+  },
+  "angularCompilerOptions": {
+    "enableI18nLegacyMessageIdFormat": false,
+    "strictInjectionParameters": true,
+    "strictInputAccessModifiers": true,
+    "strictTemplates": true
+  }
+}

package/tools/templates/frontend/nextjs/frontend/.env.example

@@ -0,0 +1,9 @@
+NEXT_PUBLIC_API_BASE=http://localhost:8080
+<% if (modules.auth) { -%>
+NEXT_PUBLIC_AUTH0_DOMAIN=your-tenant.us.auth0.com
+NEXT_PUBLIC_AUTH0_CLIENT_ID=your_spa_client_id
+NEXT_PUBLIC_AUTH0_AUDIENCE=https://api.<%= appSlug %>
+<% } -%>
+<% if (modules.payments) { -%>
+NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_xxx
+<% } -%>

package/tools/templates/frontend/nextjs/frontend/next.config.js

@@ -0,0 +1,37 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  reactStrictMode: true,
+  swcMinify: true,
+  compiler: {
+    removeConsole: process.env.NODE_ENV === 'production'
+  },
+  poweredByHeader: false,
+  compress: true,
+  images: {
+    formats: ['image/avif', 'image/webp'],
+    deviceSizes: [640, 750, 828, 1080, 1200, 1920, 2048, 3840],
+    imageSizes: [16, 32, 48, 64, 96, 128, 256, 384],
+  },
+  webpack: (config, { isServer }) => {
+    // Performance optimizations
+    config.optimization.minimize = true;
+
+    return config;
+  },
+  experimental: {
+    optimizeCss: true,
+    optimizePackageImports: ['react', 'react-dom'],
+  },
+  // Enable faster builds in development
+  ...(process.env.NODE_ENV === 'development' && {
+    webpack: (config) => {
+      config.watchOptions = {
+        poll: 1000,
+        aggregateTimeout: 300,
+      };
+      return config;
+    },
+  }),
+}
+
+module.exports = nextConfig

package/tools/templates/frontend/nextjs/frontend/package.json.ejs

@@ -0,0 +1,25 @@
+{
+  "name": "<%= appSlug %>-frontend",
+  "version": "0.0.1",
+  "private": true,
+  "scripts": {
+    "dev": "next dev -p 5173",
+    "build": "next build",
+    "start": "next start -p 5173",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "next": "^15.1.0",
+    "@auth0/auth0-spa-js": "^2.1.3"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3",
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "eslint": "^9.0.0",
+    "eslint-config-next": "^15.1.0"
+  }
+}

package/tools/templates/frontend/nextjs/frontend/src/app/globals.css

@@ -0,0 +1,31 @@
+body {
+  margin: 0;
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, Cantarell, sans-serif;
+}
+
+.app {
+  display: flex;
+  flex-direction: column;
+  min-height: 100vh;
+}
+
+nav {
+  display: flex;
+  gap: 1rem;
+  padding: 1rem;
+  background: #f0f0f0;
+}
+
+nav a {
+  text-decoration: none;
+  color: #333;
+}
+
+nav a:hover {
+  text-decoration: underline;
+}
+
+main {
+  flex: 1;
+  padding: 2rem;
+}

package/tools/templates/frontend/nextjs/frontend/src/app/layout.tsx

@@ -0,0 +1,36 @@
+import type { Metadata } from 'next';
+import Link from 'next/link';
+import './globals.css';
+
+export const metadata: Metadata = {
+  title: '<%= AppName %>',
+  description: 'Generated by create-stack',
+};
+
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <html lang="en">
+      <body>
+        <div className="app">
+          <nav>
+            <Link href="/">Home</Link>
+<% if (modules.contact) { -%>
+            <Link href="/contact">Contact</Link>
+<% } -%>
+<% if (modules.auth) { -%>
+            <Link href="/login">Login</Link>
+<% } -%>
+<% if (modules.admin) { -%>
+            <Link href="/dashboard">Dashboard</Link>
+<% } -%>
+          </nav>
+          <main>{children}</main>
+        </div>
+      </body>
+    </html>
+  );
+}

package/tools/templates/frontend/nextjs/frontend/src/app/page.tsx

@@ -0,0 +1,19 @@
+export default function Home() {
+  return (
+    <div>
+      <h1>Welcome to <%= AppName %></h1>
+      <p>This is a full-stack application built with:</p>
+      <ul>
+        <li>Frontend: <%= frontend %></li>
+        <li>Backend: <%= backend %></li>
+        <li>Database: <%= db %></li>
+<% if (modules.auth) { -%>
+        <li>Auth: <%= auth %></li>
+<% } -%>
+<% if (modules.payments) { -%>
+        <li>Payments: <%= payments %></li>
+<% } -%>
+      </ul>
+    </div>
+  );
+}

package/tools/templates/frontend/nextjs/frontend/src/lib/api.ts

@@ -0,0 +1,45 @@
+// API base URL from environment
+const API_BASE = process.env.NEXT_PUBLIC_API_BASE || 'http://localhost:8080';
+
+/**
+ * Fetch wrapper that automatically adds API base URL
+ * @param endpoint - API endpoint (e.g., '/api/example')
+ * @param options - Fetch options
+ */
+export async function apiFetch<T = any>(
+  endpoint: string,
+  options: RequestInit = {}
+): Promise<T> {
+  const url = `${API_BASE}${endpoint}`;
+
+  const config: RequestInit = {
+    ...options,
+    headers: {
+      'Content-Type': 'application/json',
+      ...options.headers,
+    },
+  };
+
+  const response = await fetch(url, config);
+
+  if (!response.ok) {
+    throw new Error(`API Error: ${response.statusText}`);
+  }
+
+  return response.json();
+}
+
+/**
+ * Example usage in components:
+ *
+ * import { apiFetch } from '@/lib/api';
+ *
+ * // GET request
+ * const data = await apiFetch('/api/example');
+ *
+ * // POST request
+ * const result = await apiFetch('/api/contact', {
+ *   method: 'POST',
+ *   body: JSON.stringify({ name: 'John', email: 'john@example.com' })
+ * });
+ */

package/tools/templates/frontend/nextjs/frontend/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/tools/templates/frontend/react/frontend/.env.example

@@ -0,0 +1,9 @@
+VITE_API_BASE=http://localhost:8080
+<% if (modules.auth) { -%>
+VITE_AUTH0_DOMAIN=your-tenant.us.auth0.com
+VITE_AUTH0_CLIENT_ID=your_spa_client_id
+VITE_AUTH0_AUDIENCE=https://api.<%= appSlug %>
+<% } -%>
+<% if (modules.payments) { -%>
+VITE_STRIPE_PUBLISHABLE_KEY=pk_test_xxx
+<% } -%>

package/tools/templates/frontend/react/frontend/.eslintrc.json

@@ -0,0 +1,32 @@
+{
+  "extends": [
+    "eslint:recommended",
+    "plugin:react/recommended",
+    "plugin:react/jsx-runtime",
+    "plugin:react-hooks/recommended"
+  ],
+  "parserOptions": {
+    "ecmaVersion": "latest",
+    "sourceType": "module",
+    "ecmaFeatures": {
+      "jsx": true
+    }
+  },
+  "settings": {
+    "react": {
+      "version": "detect"
+    }
+  },
+  "rules": {
+    "react-hooks/rules-of-hooks": "error",
+    "react-hooks/exhaustive-deps": "warn",
+    "no-unused-vars": ["warn", { "argsIgnorePattern": "^_" }],
+    "no-console": ["warn", { "allow": ["warn", "error"] }],
+    "react/prop-types": "off"
+  },
+  "env": {
+    "browser": true,
+    "es2021": true,
+    "node": true
+  }
+}

package/tools/templates/frontend/react/frontend/.prettierrc

@@ -0,0 +1,10 @@
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "arrowParens": "avoid",
+  "endOfLine": "lf"
+}