ntc-dev-kit 1.0.0__py3-none-any.whl

ntc/templates/nextjs/main.py

@@ -0,0 +1,224 @@
+import os
+import subprocess
+import sys
+import json
+import shutil
+from colorama import Fore, Style
+from ntc.utils.output import print_success, print_error, print_warning, print_info, print_progress, print_package, print_download
+
+def replace_variables(content, variables):
+    """Replace placeholders with actual variables."""
+    for key, value in variables.items():
+        content = content.replace(f"{{{key}}}", value)
+    return content
+
+def get_template_content(template_name, variables):
+    """Load template content and replace variables."""
+    # Remove 'nextjs/' prefix if present since we're already in that directory
+    if template_name.startswith("nextjs/"):
+        template_name = template_name[len("nextjs/"):]
+    
+    template_path = os.path.join(os.path.dirname(__file__), template_name)
+    if not os.path.exists(template_path):
+        return ""
+    with open(template_path, "r", encoding="utf-8") as f:
+        content = f.read()
+    return replace_variables(content, variables)
+
+def create_from_json(base_path, structure, variables):
+    """Recursively create directories and files from JSON."""
+    for name, content in structure.items():
+        name = replace_variables(name, variables)
+        full_path = os.path.join(base_path, name)
+
+        if isinstance(content, dict):
+            if "template" in content:
+                os.makedirs(os.path.dirname(full_path), exist_ok=True)
+                with open(full_path, "w", encoding="utf-8") as f:
+                    f.write(get_template_content(content["template"], variables))
+            else:
+                os.makedirs(full_path, exist_ok=True)
+                create_from_json(full_path, content, variables)
+        else:
+            os.makedirs(os.path.dirname(full_path), exist_ok=True)
+            with open(full_path, "w", encoding="utf-8") as f:
+                f.write(replace_variables(content or "", variables))
+
+def install_npm_dependencies(project_root):
+    """Install npm dependencies for Next.js project."""
+    print_package("Installing npm dependencies...")
+    
+    # Check if npm is available
+    if not shutil.which("npm"):
+        print_error("npm not found. Please install Node.js and npm first.")
+        print_info("Visit https://nodejs.org/ to download Node.js")
+        return False
+    
+    try:
+        # Change to project directory and install dependencies
+        result = subprocess.run(
+            ["npm", "install"],
+            cwd=project_root,
+            check=True,
+            capture_output=True,
+            text=True
+        )
+        print_success("npm dependencies installed successfully!")
+        return True
+    except subprocess.CalledProcessError as e:
+        print_error(f"Failed to install npm dependencies: {e}")
+        print_info("You can manually run 'npm install' in the project directory later.")
+        return False
+
+def init_nextjs_project(base_path, project_name):
+    """Initialize Next.js project structure and setup environment."""
+    structure_file = os.path.join(os.path.dirname(__file__), "structure.json")
+
+    if not os.path.exists(structure_file):
+        print_error(f"Structure file not found: {structure_file}")
+        return
+
+    with open(structure_file, "r", encoding="utf-8") as f:
+        structure = json.load(f)
+
+    project_root = os.path.join(base_path, project_name)
+    os.makedirs(project_root, exist_ok=True)
+
+    variables = {
+        "project_name": project_name,
+    }
+
+    create_from_json(project_root, structure["{project_name}"], variables)
+    print_success(f"Next.js project '{project_name}' initialized at: {project_root}")
+
+    # Ask user for dependency installation
+    print(f"\n{Fore.CYAN}{Style.BRIGHT}📦 NODE.JS DEPENDENCY SETUP{Style.RESET_ALL}")
+    print("─" * 40)
+    print(f"{Fore.YELLOW}{Style.BRIGHT}[1]{Style.RESET_ALL} {Fore.WHITE}Install dependencies now (npm install){Style.RESET_ALL}")
+    print(f"{Fore.YELLOW}{Style.BRIGHT}[2]{Style.RESET_ALL} {Fore.WHITE}Use existing node_modules (if available){Style.RESET_ALL}")
+    print(f"{Fore.YELLOW}{Style.BRIGHT}[3]{Style.RESET_ALL} {Fore.WHITE}Skip dependency installation{Style.RESET_ALL}")
+    
+    while True:
+        deps_choice = input(f"{Fore.WHITE}{Style.BRIGHT}❓ Select dependency option (1-3): {Style.RESET_ALL}").strip()
+        
+        # Clear screen after selection
+        os.system('cls' if os.name == 'nt' else 'clear')
+        
+        if deps_choice == "1":
+            # Install dependencies now
+            install_npm_dependencies(project_root)
+            break
+            
+        elif deps_choice == "2":
+            # Check for existing node_modules
+            node_modules_path = os.path.join(project_root, "node_modules")
+            if os.path.exists(node_modules_path):
+                print_success("Found existing node_modules directory!")
+                print_info("Using existing dependencies. Run 'npm install' if you need to update them.")
+            else:
+                print_warning("No existing node_modules found in this location.")
+                print_info("You may need to run 'npm install' manually later.")
+            break
+            
+        elif deps_choice == "3":
+            # Skip installation
+            print_info("Skipping dependency installation.")
+            print_info("Remember to run 'npm install' before starting development.")
+            break
+            
+        else:
+            print_error("Invalid choice. Please select 1, 2, or 3.")
+
+    # Show next steps
+    print(f"\n{Fore.GREEN}{Style.BRIGHT}🎉 PROJECT READY!{Style.RESET_ALL}")
+    print("─" * 30)
+    print_info("Next steps:")
+    print(f"  1. cd {project_name}")
+    if deps_choice != "1":
+        print("  2. npm install")
+        print("  3. npm run dev")
+    else:
+        print("  2. npm run dev")
+    print_info("Your Next.js app will be available at http://localhost:3000")
+    print_info("Make sure your backend API is running on http://localhost:8000")
+
+def init_nextjs_project_in_current_dir(project_name):
+    """Initialize Next.js project structure in the current directory."""
+    structure_file = os.path.join(os.path.dirname(__file__), "structure.json")
+
+    if not os.path.exists(structure_file):
+        print_error(f"Structure file not found: {structure_file}")
+        return
+
+    with open(structure_file, "r", encoding="utf-8") as f:
+        structure = json.load(f)
+
+    project_root = os.getcwd()  # Use current directory
+
+    variables = {
+        "project_name": project_name,
+    }
+
+    # Check if current directory is empty or ask for confirmation
+    existing_files = [f for f in os.listdir(project_root) if not f.startswith('.')]
+    if existing_files:
+        print_warning(f"Current directory is not empty. Found {len(existing_files)} files/folders.")
+        print_info("Existing items: " + ", ".join(existing_files[:5]) + ("..." if len(existing_files) > 5 else ""))
+        
+        confirm = input(f"{Fore.WHITE}{Style.BRIGHT}❓ Continue anyway? (y/N): {Style.RESET_ALL}").strip().lower()
+        if confirm != 'y':
+            print_info("Project initialization cancelled.")
+            return
+
+    create_from_json(project_root, structure["{project_name}"], variables)
+    print_success(f"Next.js project '{project_name}' initialized in current directory: {project_root}")
+
+    # Ask user for dependency installation
+    print(f"\n{Fore.CYAN}{Style.BRIGHT}📦 NODE.JS DEPENDENCY SETUP{Style.RESET_ALL}")
+    print("─" * 40)
+    print(f"{Fore.YELLOW}{Style.BRIGHT}[1]{Style.RESET_ALL} {Fore.WHITE}Install dependencies now (npm install){Style.RESET_ALL}")
+    print(f"{Fore.YELLOW}{Style.BRIGHT}[2]{Style.RESET_ALL} {Fore.WHITE}Use existing node_modules (if available){Style.RESET_ALL}")
+    print(f"{Fore.YELLOW}{Style.BRIGHT}[3]{Style.RESET_ALL} {Fore.WHITE}Skip dependency installation{Style.RESET_ALL}")
+    
+    while True:
+        deps_choice = input(f"{Fore.WHITE}{Style.BRIGHT}❓ Select dependency option (1-3): {Style.RESET_ALL}").strip()
+        
+        # Clear screen after selection
+        os.system('cls' if os.name == 'nt' else 'clear')
+        
+        if deps_choice == "1":
+            # Install dependencies now
+            install_npm_dependencies(project_root)
+            break
+            
+        elif deps_choice == "2":
+            # Check for existing node_modules
+            node_modules_path = os.path.join(project_root, "node_modules")
+            if os.path.exists(node_modules_path):
+                print_success("Found existing node_modules directory!")
+                print_info("Using existing dependencies. Run 'npm install' if you need to update them.")
+            else:
+                print_warning("No existing node_modules found in this location.")
+                print_info("You may need to run 'npm install' manually later.")
+            break
+            
+        elif deps_choice == "3":
+            # Skip installation
+            print_info("Skipping dependency installation.")
+            print_info("Remember to run 'npm install' before starting development.")
+            break
+            
+        else:
+            print_error("Invalid choice. Please select 1, 2, or 3.")
+
+    # Show next steps
+    print(f"\n{Fore.GREEN}{Style.BRIGHT}🎉 PROJECT READY!{Style.RESET_ALL}")
+    print("─" * 30)
+    print_info("Next steps:")
+    if deps_choice != "1":
+        print("  1. npm install")
+        print("  2. npm run dev")
+    else:
+        print("  1. npm run dev")
+    print_info("Your Next.js app will be available at http://localhost:3000")
+    print_info("Make sure your backend API is running on http://localhost:8000")

ntc/templates/nextjs/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "{project_name}",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "next": "^15.0.0",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "axios": "^1.13.6"
+  },
+  "devDependencies": {
+    "@types/node": "^24.12.0",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "typescript": "~5.9.3",
+    "eslint": "^9.39.4",
+    "eslint-config-next": "^15.0.0"
+  }
+}

ntc/templates/nextjs/src/app/globals.css

@@ -0,0 +1,26 @@
+* {
+  box-sizing: border-box;
+  padding: 0;
+  margin: 0;
+}
+
+html,
+body {
+  max-width: 100vw;
+  overflow-x: hidden;
+}
+
+body {
+  background: #ffffff;
+  color: #000000;
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen',
+    'Ubuntu', 'Cantarell', 'Fira Sans', 'Droid Sans', 'Helvetica Neue',
+    sans-serif;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+a {
+  color: inherit;
+  text-decoration: none;
+}

ntc/templates/nextjs/src/app/layout.tsx

@@ -0,0 +1,59 @@
+import type { Metadata } from 'next'
+import { Inter } from 'next/font/google'
+import './globals.css'
+
+const inter = Inter({ subsets: ['latin'] })
+
+export const metadata: Metadata = {
+  title: '{project_name}',
+  description: process.env.NEXT_PUBLIC_SITE_DESCRIPTION || 'A modern website built with Next.js',
+  keywords: process.env.NEXT_PUBLIC_SITE_KEYWORDS?.split(',') || ['nextjs', 'react', 'typescript'],
+  authors: [{ name: '{project_name}' }],
+  creator: '{project_name}',
+  publisher: '{project_name}',
+  metadataBase: new URL(process.env.NEXT_PUBLIC_SITE_URL || 'http://localhost:3000'),
+  openGraph: {
+    type: 'website',
+    locale: 'en_US',
+    url: process.env.NEXT_PUBLIC_SITE_URL || 'http://localhost:3000',
+    title: '{project_name}',
+    description: process.env.NEXT_PUBLIC_SITE_DESCRIPTION || 'A modern website built with Next.js',
+    siteName: '{project_name}',
+  },
+  twitter: {
+    card: 'summary_large_image',
+    title: '{project_name}',
+    description: process.env.NEXT_PUBLIC_SITE_DESCRIPTION || 'A modern website built with Next.js',
+  },
+  robots: {
+    index: true,
+    follow: true,
+    googleBot: {
+      index: true,
+      follow: true,
+      'max-video-preview': -1,
+      'max-image-preview': 'large',
+      'max-snippet': -1,
+    },
+  },
+  verification: {
+    google: '',
+    yandex: '',
+  },
+}
+
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode
+}) {
+  return (
+    <html lang="en">
+      <head>
+        <link rel="icon" href="/favicon.ico" />
+        <link rel="canonical" href={process.env.NEXT_PUBLIC_SITE_URL || 'http://localhost:3000'} />
+      </head>
+      <body className={inter.className}>{children}</body>
+    </html>
+  )
+}

ntc/templates/nextjs/src/app/page.tsx

@@ -0,0 +1,21 @@
+import { Metadata } from 'next'
+import Header from '@/components/Header'
+
+export const metadata: Metadata = {
+  title: 'Home - {project_name}',
+  description: 'Welcome to {project_name}',
+}
+
+export default function Home() {
+  return (
+    <main>
+      <Header />
+      <section className="hero">
+        <div className="container">
+          <h1>Welcome to {process.env.NEXT_PUBLIC_SITE_NAME || '{project_name}'}</h1>
+          <p>A modern website built with Next.js, React, and TypeScript</p>
+        </div>
+      </section>
+    </main>
+  )
+}

ntc/templates/nextjs/src/components/Header.tsx

@@ -0,0 +1,16 @@
+export default function Header() {
+  return (
+    <header>
+      <nav>
+        <div className="container">
+          <h1>{process.env.NEXT_PUBLIC_SITE_NAME || '{project_name}'}</h1>
+          <ul>
+            <li><a href="/">Home</a></li>
+            <li><a href="/about">About</a></li>
+            <li><a href="/contact">Contact</a></li>
+          </ul>
+        </div>
+      </nav>
+    </header>
+  )
+}

ntc/templates/nextjs/src/services/api.ts

@@ -0,0 +1,81 @@
+import axios from 'axios'
+import { API_BASE_URL } from '@/utils/constants'
+
+const apiClient = axios.create({
+  baseURL: API_BASE_URL,
+  timeout: 10000,
+  headers: {
+    'Content-Type': 'application/json',
+  },
+})
+
+apiClient.interceptors.request.use(
+  (config) => {
+    const token = localStorage.getItem('authToken')
+    if (token) {
+      config.headers.Authorization = `Bearer ${token}`
+    }
+    return config
+  },
+  (error) => {
+    return Promise.reject(error)
+  }
+)
+
+apiClient.interceptors.response.use(
+  (response) => {
+    return response
+  },
+  (error) => {
+    if (error.response?.status === 401) {
+      localStorage.removeItem('authToken')
+    }
+    return Promise.reject(error)
+  }
+)
+
+export const apiService = {
+  get: (url: string, config = {}) => {
+    return apiClient.get(url, config)
+  },
+
+  post: (url: string, data = {}, config = {}) => {
+    return apiClient.post(url, data, config)
+  },
+
+  put: (url: string, data = {}, config = {}) => {
+    return apiClient.put(url, data, config)
+  },
+
+  patch: (url: string, data = {}, config = {}) => {
+    return apiClient.patch(url, data, config)
+  },
+
+  delete: (url: string, config = {}) => {
+    return apiClient.delete(url, config)
+  },
+}
+
+export const authService = {
+  login: async (credentials: any) => {
+    const response = await apiService.post('/auth/login/', credentials)
+    if (response.data.token) {
+      localStorage.setItem('authToken', response.data.token)
+    }
+    return response
+  },
+
+  logout: () => {
+    localStorage.removeItem('authToken')
+  },
+
+  getCurrentUser: () => {
+    return apiService.get('/auth/user/')
+  },
+
+  isAuthenticated: () => {
+    return !!localStorage.getItem('authToken')
+  },
+}
+
+export default apiService

ntc/templates/nextjs/src/utils/constants.ts

@@ -0,0 +1 @@
+export const API_BASE_URL = process.env.NEXT_PUBLIC_API_BASE_URL || 'http://localhost:8000'

ntc/templates/nextjs/structure.json

@@ -0,0 +1,32 @@
+{
+  "{project_name}": {
+    "package.json": { "template": "nextjs/package.json" },
+    ".gitignore": "node_modules/\n.next/\n.env.local\n.env.development.local\n.env.test.local\n.env.production.local\nnpm-debug.log*\nyarn-debug.log*\nyarn-error.log*\n.DS_Store\n",
+    "README.md": "# {project_name}\n\nA modern Next.js website with SEO best practices, initialized by `ntc init`.\n\n## Tech Stack\n\n- Next.js 15\n- React 19\n- TypeScript\n- Axios for API communication\n\n## Getting Started\n\n```bash\nnpm install\nnpm run dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000) with your browser to see the result.\n\n## Available Scripts\n\n- `npm run dev` - Starts the development server\n- `npm run build` - Creates an optimized production build\n- `npm start` - Starts the production server\n- `npm run lint` - Runs ESLint\n\n## SEO Features\n\nThis template includes comprehensive SEO optimizations:\n\n- **Metadata API**: Next.js Metadata API for dynamic meta tags\n- **Open Graph**: Social media sharing optimization\n- **Twitter Cards**: Twitter card support\n- **Canonical URLs**: Prevent duplicate content issues\n",
+    "next.config.js": { "template": "nextjs/next.config.js" },
+    "tsconfig.json": { "template": "nextjs/tsconfig.json" },
+    ".env.example": { "template": "nextjs/.env.example" },
+    "CLAUDE.md": { "template": "nextjs/CLAUDE.md" },
+    ".knowledge": {
+      "knowledge_structure.md": { "template": "nextjs/knowledge/knowledge_structure.md" },
+      "knowledge_description.md": { "template": "nextjs/knowledge/knowledge_description.md" },
+      "knowledge_design_pattern.md": { "template": "nextjs/knowledge/knowledge_design_pattern.md" }
+    },
+    "src": {
+      "app": {
+        "layout.tsx": { "template": "nextjs/src/app/layout.tsx" },
+        "page.tsx": { "template": "nextjs/src/app/page.tsx" },
+        "globals.css": { "template": "nextjs/src/app/globals.css" }
+      },
+      "components": {
+        "Header.tsx": { "template": "nextjs/src/components/Header.tsx" }
+      },
+      "services": {
+        "api.ts": { "template": "nextjs/src/services/api.ts" }
+      },
+      "utils": {
+        "constants.ts": { "template": "nextjs/src/utils/constants.ts" }
+      }
+    }
+  }
+}

ntc/templates/nextjs/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "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"]
+}

ntc/templates/react_admin/.env.example

@@ -0,0 +1 @@
+VITE_API_BASE_URL=http://localhost:8000/v1

ntc/templates/react_admin/.gitignore

@@ -0,0 +1,10 @@
+node_modules/
+dist/
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.DS_Store