next-skill 1.0.0 → 1.0.1

package/README.md

@@ -0,0 +1,20 @@
+# `next-skill`
+
+A command-line tool to bootstrap a new Next.js project with best practices and a predefined project structure. It sets up a new application and includes a `.claude/SKILLS.md` file to guide AI-assisted development.
+
+## Usage
+
+To create a new Next.js project, run the following command in your terminal:
+
+```bash
+npx next-skill
+```
+
+The script will prompt you to enter a name for your project folder. If you press enter without a name, it will install the new Next.js application in the current directory.
+
+### What it does
+
+1.  **Creates a new Next.js application**: It runs `create-next-app` to scaffold a new project.
+2.  **Adds AI Development Standards**: It creates a `.claude/SKILLS.md` file in your project. This file contains a set of development standards and best practices optimized for working with AI assistants like Claude.
+3.  **Sets up Project Structure**: It creates common folders like `components`, `lib`, and `utils` to organize your code. It correctly handles both standard and `src` directory layouts.
+4.  **Environment Files**: It creates `.env` and `.env.local` files for managing your environment variables.

package/index.js

@@ -109,22 +109,39 @@ async function main() {
 function createProjectFolders(targetDir) {
   const projectPath = path.join(process.cwd(), targetDir);
   const appDir = path.join(projectPath, 'app');
-  const pagesDir = path.join(projectPath, 'pages');
+  const srcDir = path.join(projectPath, 'src');
+  const srcAppDir = path.join(srcDir, 'app');
+  const pagesDir = path.join(projectPath, 'pages'); // Still useful to differentiate App vs Pages router
+
+  let isAppRouter = false;
+  let basePath = projectPath; // Default to root
+
+  // Check for App Router in src directory first
+  if (fs.existsSync(srcAppDir) && !fs.existsSync(pagesDir)) {
+    isAppRouter = true;
+    basePath = srcDir; // If src/app exists, new folders go inside src
+    console.log('App Router with src directory setup detected.');
+  }
+  // Then check for App Router in root directory
+  else if (fs.existsSync(appDir) && !fs.existsSync(pagesDir)) {
+    isAppRouter = true;
+    basePath = projectPath; // If app exists at root, new folders go at root
+    console.log('App Router setup detected.');
+  }
 
-  // Check if it's an App Router project
-  if (fs.existsSync(appDir) && !fs.existsSync(pagesDir)) {
-    console.log('App Router setup detected. Creating additional folders...');
+  if (isAppRouter) {
+    console.log('Creating additional folders...');
     const foldersToCreate = ['components', 'lib', 'utils'];
     foldersToCreate.forEach(folder => {
-      const folderPath = path.join(projectPath, folder);
+      const folderPath = path.join(basePath, folder);
       if (!fs.existsSync(folderPath)) {
         fs.mkdirSync(folderPath, { recursive: true });
-        console.log(`Created folder: ${folder}`);
+        console.log(`Created folder: ${path.relative(projectPath, folderPath)}`);
       }
     });
   }
 
-  // Create .env and .env.local files
+  // Create .env and .env.local files at the project root
   const envFiles = ['.env', '.env.local'];
   envFiles.forEach(file => {
     const filePath = path.join(projectPath, file);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "next-skill",
-  "version": "1.0.0",
-  "description": "Create a Next.js app with .claude/SKILLS.md",
+  "version": "1.0.1",
+  "description": "Create a Next.js app with .claude/SKILLS.md and folders for components, libs, and utils along with env files.",
   "main": "index.js",
   "bin": {
     "next-skill": "./index.js"