create-nene 0.1.1 → 0.2.0

package/templates/default/README.md

@@ -1,43 +1,60 @@
 # My Nene App
 
-This project was bootstrapped with [create-nene](https://nene.js.org).
+A full-stack monorepo with Next.js frontend and NestJS backend.
+
+## Project Structure
+
+```
+├── apps/
+│   ├── web/          # Next.js frontend (port 3000)
+│   └── api/          # NestJS backend (port 4000)
+├── packages/
+│   └── shared/       # Shared types, DTOs, utilities
+└── docs/             # Project documentation
+```
 
 ## Getting Started
 
-First, run the development server:
+### Prerequisites
+
+- Node.js 18+
+- pnpm 9+
+
+### Installation
 
 ```bash
-npm run dev
-# or
-yarn dev
-# or
-pnpm dev
+pnpm install
 ```
 
-Open [http://localhost:3000](http://localhost:3000) in your browser to see the result.
+### Development
 
-## Project Structure
+Run both frontend and backend:
 
+```bash
+pnpm dev
 ```
-my-nene-app/
-├── src/
-│   ├── app/           # Frontend pages and layouts
-│   │   ├── page.tsx   # Home page
-│   │   └── layout.tsx # Root layout
-│   └── server/        # Backend API and services
-│       └── api/       # API routes
-├── public/            # Static assets
-├── package.json
-└── tsconfig.json
+
+Run only frontend:
+
+```bash
+pnpm dev:web
 ```
 
-## Learn More
+Run only backend:
 
-To learn more about nene.js, check out the following resources:
+```bash
+pnpm dev:api
+```
+
+### Build
 
-- [nene.js Documentation](https://nene.js.org/docs) - learn about nene.js features and API.
-- [GitHub Repository](https://github.com/nene-js/nene) - your feedback and contributions are welcome!
+```bash
+pnpm build
+```
 
-## Deploy
+## Tech Stack
 
-Deploy your nene.js app with [Vercel](https://vercel.com) or any Node.js hosting platform.
+- **Frontend**: Next.js 15, React 19, Tailwind CSS
+- **Backend**: NestJS 11, class-validator
+- **Shared**: TypeScript, shared types and DTOs
+- **Tooling**: Turborepo, pnpm workspaces

package/templates/default/_gitignore

@@ -1,13 +1,11 @@
 # Dependencies
-node_modules/
-.pnp
-.pnp.js
+node_modules
+.pnpm-store
 
-# Build
-dist/
-.nene/
-.next/
-out/
+# Build outputs
+dist
+.next
+.turbo
 
 # Environment
 .env
@@ -15,8 +13,8 @@ out/
 .env.*.local
 
 # IDE
-.idea/
-.vscode/
+.idea
+.vscode
 *.swp
 *.swo
 
@@ -27,15 +25,10 @@ Thumbs.db
 # Logs
 *.log
 npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
 pnpm-debug.log*
 
 # Testing
-coverage/
-
-# TypeScript
-*.tsbuildinfo
+coverage
 
 # Misc
-.vercel
+*.tsbuildinfo

package/templates/default/apps/api/nest-cli.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://json.schemastore.org/nest-cli",
+  "collection": "@nestjs/schematics",
+  "sourceRoot": "src",
+  "compilerOptions": {
+    "deleteOutDir": true
+  }
+}

package/templates/default/apps/api/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@app/api",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "nest start --watch",
+    "build": "nest build",
+    "start": "node dist/main",
+    "start:prod": "node dist/main",
+    "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
+    "test": "jest",
+    "test:watch": "jest --watch"
+  },
+  "dependencies": {
+    "@app/shared": "workspace:*",
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/config": "^4.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@nestjs/platform-express": "^11.0.0",
+    "class-transformer": "^0.5.1",
+    "class-validator": "^0.14.1",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.1"
+  },
+  "devDependencies": {
+    "@nestjs/cli": "^11.0.0",
+    "@nestjs/schematics": "^11.0.0",
+    "@nestjs/testing": "^11.0.0",
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.0.0",
+    "ts-loader": "^9.5.1",
+    "ts-node": "^10.9.2",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "^5.7.0"
+  }
+}

package/templates/default/apps/api/src/app.controller.ts

@@ -0,0 +1,12 @@
+import { Controller, Get } from '@nestjs/common';
+import { AppService } from './app.service';
+
+@Controller()
+export class AppController {
+  constructor(private readonly appService: AppService) {}
+
+  @Get()
+  getHello(): string {
+    return this.appService.getHello();
+  }
+}

package/templates/default/apps/api/src/app.module.ts

@@ -0,0 +1,19 @@
+import { Module } from '@nestjs/common';
+import { ConfigModule } from '@nestjs/config';
+import { AppController } from './app.controller';
+import { AppService } from './app.service';
+import { HealthModule } from './health/health.module';
+import configuration from './config/configuration';
+
+@Module({
+  imports: [
+    ConfigModule.forRoot({
+      isGlobal: true,
+      load: [configuration],
+    }),
+    HealthModule,
+  ],
+  controllers: [AppController],
+  providers: [AppService],
+})
+export class AppModule {}

package/templates/default/apps/api/src/app.service.ts

@@ -0,0 +1,8 @@
+import { Injectable } from '@nestjs/common';
+
+@Injectable()
+export class AppService {
+  getHello(): string {
+    return 'Welcome to the API!';
+  }
+}

package/templates/default/apps/api/src/config/configuration.ts

@@ -0,0 +1,6 @@
+export default () => ({
+  port: parseInt(process.env.PORT, 10) || 4000,
+  frontend: {
+    url: process.env.FRONTEND_URL || 'http://localhost:3000',
+  },
+});

package/templates/default/apps/api/src/health/health.controller.ts

@@ -0,0 +1,12 @@
+import { Controller, Get } from '@nestjs/common';
+import { HealthService } from './health.service';
+
+@Controller('health')
+export class HealthController {
+  constructor(private readonly healthService: HealthService) {}
+
+  @Get()
+  check() {
+    return this.healthService.check();
+  }
+}

package/templates/default/apps/api/src/health/health.module.ts

@@ -0,0 +1,9 @@
+import { Module } from '@nestjs/common';
+import { HealthController } from './health.controller';
+import { HealthService } from './health.service';
+
+@Module({
+  controllers: [HealthController],
+  providers: [HealthService],
+})
+export class HealthModule {}

package/templates/default/apps/api/src/health/health.service.ts

@@ -0,0 +1,12 @@
+import { Injectable } from '@nestjs/common';
+
+@Injectable()
+export class HealthService {
+  check() {
+    return {
+      status: 'ok',
+      timestamp: new Date().toISOString(),
+      uptime: process.uptime(),
+    };
+  }
+}

package/templates/default/apps/api/src/main.ts

@@ -0,0 +1,32 @@
+import { NestFactory } from '@nestjs/core';
+import { ValidationPipe } from '@nestjs/common';
+import { AppModule } from './app.module';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+
+  // Enable CORS for frontend
+  app.enableCors({
+    origin: process.env.FRONTEND_URL || 'http://localhost:3000',
+    credentials: true,
+  });
+
+  // Global validation pipe
+  app.useGlobalPipes(
+    new ValidationPipe({
+      whitelist: true,
+      forbidNonWhitelisted: true,
+      transform: true,
+    }),
+  );
+
+  // Global prefix for API routes
+  app.setGlobalPrefix('api');
+
+  const port = process.env.PORT || 4000;
+  await app.listen(port);
+
+  console.log(`API server running on http://localhost:${port}`);
+}
+
+bootstrap();

package/templates/default/apps/api/tsconfig.json

@@ -0,0 +1,26 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "declaration": true,
+    "removeComments": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "allowSyntheticDefaultImports": true,
+    "target": "ES2021",
+    "sourceMap": true,
+    "outDir": "./dist",
+    "baseUrl": "./",
+    "incremental": true,
+    "skipLibCheck": true,
+    "strictNullChecks": true,
+    "noImplicitAny": true,
+    "strictBindCallApply": true,
+    "forceConsistentCasingInFileNames": true,
+    "noFallthroughCasesInSwitch": true,
+    "paths": {
+      "@/*": ["src/*"]
+    }
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/default/apps/web/next.config.ts

@@ -0,0 +1,7 @@
+import type { NextConfig } from 'next';
+
+const nextConfig: NextConfig = {
+  transpilePackages: ['@app/shared'],
+};
+
+export default nextConfig;

package/templates/default/apps/web/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@app/web",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint ."
+  },
+  "dependencies": {
+    "@app/shared": "workspace:*",
+    "next": "^15.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "autoprefixer": "^10.4.20",
+    "eslint": "^9.0.0",
+    "eslint-config-next": "^15.0.0",
+    "postcss": "^8.4.49",
+    "tailwindcss": "^3.4.15",
+    "typescript": "^5.7.0"
+  }
+}

package/templates/default/apps/web/postcss.config.mjs

@@ -0,0 +1,9 @@
+/** @type {import('postcss-load-config').Config} */
+const config = {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+};
+
+export default config;

package/templates/default/apps/web/src/app/globals.css

@@ -0,0 +1,20 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+:root {
+  --foreground-rgb: 0, 0, 0;
+  --background-rgb: 255, 255, 255;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --foreground-rgb: 255, 255, 255;
+    --background-rgb: 10, 10, 10;
+  }
+}
+
+body {
+  color: rgb(var(--foreground-rgb));
+  background: rgb(var(--background-rgb));
+}

package/templates/default/apps/web/src/app/layout.tsx

@@ -0,0 +1,19 @@
+import type { Metadata } from 'next';
+import './globals.css';
+
+export const metadata: Metadata = {
+  title: 'My Nene App',
+  description: 'A full-stack app built with Next.js and NestJS',
+};
+
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  );
+}

package/templates/default/apps/web/src/app/page.tsx

@@ -0,0 +1,75 @@
+'use client';
+
+import { useEffect, useState } from 'react';
+import { API_ROUTES } from '@app/shared';
+
+interface HealthStatus {
+  status: string;
+  timestamp: string;
+  uptime: number;
+}
+
+export default function Home() {
+  const [health, setHealth] = useState<HealthStatus | null>(null);
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    const checkHealth = async () => {
+      try {
+        const res = await fetch(`http://localhost:4000${API_ROUTES.HEALTH}`);
+        const data = await res.json();
+        setHealth(data);
+      } catch (err) {
+        setError('API server is not running');
+      }
+    };
+
+    checkHealth();
+  }, []);
+
+  return (
+    <main className="flex min-h-screen flex-col items-center justify-center p-24">
+      <h1 className="text-4xl font-bold mb-8">Welcome to nene.js</h1>
+      <p className="text-lg text-gray-600 mb-8">
+        A full-stack monorepo with Next.js and NestJS
+      </p>
+
+      <div className="bg-gray-100 dark:bg-gray-800 rounded-lg p-6 w-full max-w-md">
+        <h2 className="text-xl font-semibold mb-4">API Health Check</h2>
+        {error ? (
+          <p className="text-red-500">{error}</p>
+        ) : health ? (
+          <div className="space-y-2">
+            <p>
+              Status:{' '}
+              <span className="text-green-500 font-medium">{health.status}</span>
+            </p>
+            <p className="text-sm text-gray-500">
+              Uptime: {Math.floor(health.uptime)}s
+            </p>
+          </div>
+        ) : (
+          <p className="text-gray-500">Checking...</p>
+        )}
+      </div>
+
+      <div className="mt-12 grid grid-cols-2 gap-4 text-center">
+        <a
+          href="http://localhost:4000/api"
+          target="_blank"
+          className="p-4 border rounded-lg hover:bg-gray-50 dark:hover:bg-gray-800"
+        >
+          <h3 className="font-semibold">API Server</h3>
+          <p className="text-sm text-gray-500">localhost:4000</p>
+        </a>
+        <a
+          href="/docs"
+          className="p-4 border rounded-lg hover:bg-gray-50 dark:hover:bg-gray-800"
+        >
+          <h3 className="font-semibold">Documentation</h3>
+          <p className="text-sm text-gray-500">View docs</p>
+        </a>
+      </div>
+    </main>
+  );
+}

package/templates/default/apps/web/tailwind.config.ts

@@ -0,0 +1,15 @@
+import type { Config } from 'tailwindcss';
+
+const config: Config = {
+  content: [
+    './src/pages/**/*.{js,ts,jsx,tsx,mdx}',
+    './src/components/**/*.{js,ts,jsx,tsx,mdx}',
+    './src/app/**/*.{js,ts,jsx,tsx,mdx}',
+  ],
+  theme: {
+    extend: {},
+  },
+  plugins: [],
+};
+
+export default config;

package/templates/default/{tsconfig.json → apps/web/tsconfig.json}

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

package/templates/default/docs/API.md

@@ -0,0 +1,55 @@
+# API Reference
+
+## Base URL
+
+```
+http://localhost:4000/api
+```
+
+## Endpoints
+
+### Health Check
+
+#### GET /api/health
+
+Check if the API server is running.
+
+**Response:**
+```json
+{
+  "status": "ok",
+  "timestamp": "2024-01-01T00:00:00.000Z",
+  "uptime": 123.456
+}
+```
+
+### Root
+
+#### GET /api
+
+Returns a welcome message.
+
+**Response:**
+```
+Welcome to the API!
+```
+
+## Error Handling
+
+All errors follow this format:
+
+```json
+{
+  "statusCode": 400,
+  "message": "Error description",
+  "error": "Bad Request"
+}
+```
+
+## Authentication
+
+(To be implemented)
+
+## Rate Limiting
+
+(To be implemented)

package/templates/default/docs/ARCHITECTURE.md

@@ -0,0 +1,56 @@
+# Architecture
+
+This document describes the architecture of this project for AI agents and developers.
+
+## Overview
+
+This is a full-stack monorepo with:
+- **Frontend**: Next.js 15 with React 19
+- **Backend**: NestJS 11 with class-validator
+- **Shared**: TypeScript types and constants
+
+## Project Structure
+
+```
+├── apps/
+│   ├── web/              # Next.js frontend
+│   │   ├── src/app/      # App router pages
+│   │   └── src/          # Components, hooks, utils
+│   └── api/              # NestJS backend
+│       └── src/          # Modules, controllers, services
+├── packages/
+│   └── shared/           # Shared types and constants
+│       └── src/
+│           ├── types/    # TypeScript interfaces
+│           └── constants/# API routes, constants
+└── docs/                 # Project documentation
+```
+
+## Data Flow
+
+```
+[Browser] <--HTTP--> [Next.js :3000] <--HTTP--> [NestJS :4000] <---> [Database]
+                            |                         |
+                            +---- @app/shared --------+
+                                (types, constants)
+```
+
+## Key Patterns
+
+### API Communication
+- Frontend calls backend via REST API
+- Shared types ensure type safety across the stack
+- API routes defined in `@app/shared/constants`
+
+### Validation
+- Backend uses class-validator for request validation
+- DTOs can be shared between frontend and backend
+
+### Configuration
+- Backend uses @nestjs/config for environment management
+- Frontend uses Next.js environment variables
+
+## Ports
+
+- Frontend (web): http://localhost:3000
+- Backend (api): http://localhost:4000