claude-code-templates 1.21.11 → 1.21.13

package/cli-tool/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "claude-code-templates",
+  "version": "1.21.13",
+  "description": "CLI tool to setup Claude Code configurations with framework-specific commands, automation hooks and MCP Servers for your projects",
+  "main": "src/index.js",
+  "bin": {
+    "create-claude-config": "bin/create-claude-config.js",
+    "claude-code-templates": "bin/create-claude-config.js",
+    "claude-code-template": "bin/create-claude-config.js",
+    "claude-init": "bin/create-claude-config.js",
+    "cctemplates": "bin/create-claude-config.js",
+    "cct": "bin/create-claude-config.js",
+    "claude-setup": "bin/create-claude-config.js",
+    "claude-config": "bin/create-claude-config.js"
+  },
+  "scripts": {
+    "start": "node bin/create-claude-config.js",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:unit": "jest tests/unit",
+    "test:integration": "jest tests/integration",
+    "test:e2e": "jest tests/e2e",
+    "test:analytics": "jest --testPathPattern=analytics",
+    "test:commands": "./test-commands.sh",
+    "test:detailed": "./test-detailed.sh",
+    "test:react": "make test-react",
+    "test:vue": "make test-vue",
+    "test:node": "make test-node",
+    "test:all": "npm run test:coverage && make test",
+    "dev:link": "npm link",
+    "dev:unlink": "npm unlink -g claude-code-templates",
+    "pretest:commands": "npm run dev:link",
+    "analytics:start": "node src/analytics.js",
+    "analytics:test": "npm run test:analytics"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "configuration",
+    "template",
+    "setup",
+    "cli",
+    "hooks",
+    "automation",
+    "javascript",
+    "typescript",
+    "react",
+    "vue",
+    "angular",
+    "nodejs",
+    "python",
+    "django",
+    "flask",
+    "fastapi",
+    "rust",
+    "go"
+  ],
+  "author": "Claude Code Templates",
+  "license": "MIT",
+  "dependencies": {
+    "boxen": "^5.1.2",
+    "chalk": "^4.1.2",
+    "chokidar": "^3.5.3",
+    "commander": "^11.1.0",
+    "express": "^4.18.2",
+    "fs-extra": "^11.1.1",
+    "inquirer": "^8.2.6",
+    "open": "^8.4.2",
+    "ora": "^5.4.1",
+    "uuid": "^11.1.0",
+    "ws": "^8.18.3"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/davila7/claude-code-templates.git"
+  },
+  "bugs": {
+    "url": "https://github.com/davila7/claude-code-templates/issues"
+  },
+  "homepage": "https://github.com/davila7/claude-code-templates#readme",
+  "files": [
+    "bin/",
+    "src/",
+    "components/sandbox/e2b/",
+    "README.md"
+  ],
+  "devDependencies": {
+    "jest": "^30.0.4",
+    "jest-watch-typeahead": "^3.0.1"
+  }
+}

package/{src → cli-tool/src}/index.js

@@ -959,6 +959,28 @@ async function installIndividualHook(hookName, targetDir, options) {
     const hookConfigText = await response.text();
     const hookConfig = JSON.parse(hookConfigText);
 
+    // Check if there are additional files to download (e.g., Python scripts for hooks)
+    const additionalFiles = {};
+
+    // Check if there's a corresponding Python file for ANY hook
+    const pythonUrl = githubUrl.replace('.json', '.py');
+    const hookBaseName = hookName.includes('/') ? hookName.split('/').pop() : hookName;
+
+    try {
+      console.log(chalk.gray(`📥 Checking for additional Python script...`));
+      const pythonResponse = await fetch(pythonUrl);
+      if (pythonResponse.ok) {
+        const pythonContent = await pythonResponse.text();
+        additionalFiles[`.claude/hooks/${hookBaseName}.py`] = {
+          content: pythonContent,
+          executable: true
+        };
+        console.log(chalk.green(`✓ Found Python script: ${hookBaseName}.py`));
+      }
+    } catch (error) {
+      // Python file is optional, silently continue if not found
+    }
+
     // Remove description field before merging
     if (hookConfig && typeof hookConfig === 'object') {
       delete hookConfig.description;
@@ -1148,7 +1170,25 @@ async function installIndividualHook(hookName, targetDir, options) {
       
       // Write the merged configuration
       await fs.writeJson(actualTargetFile, mergedConfig, { spaces: 2 });
-      
+
+      // Install additional files (e.g., Python scripts)
+      if (Object.keys(additionalFiles).length > 0) {
+        for (const [relativePath, fileData] of Object.entries(additionalFiles)) {
+          const absolutePath = path.join(currentTargetDir, relativePath);
+          const dir = path.dirname(absolutePath);
+
+          // Ensure directory exists
+          await fs.ensureDir(dir);
+
+          // Write file
+          await fs.writeFile(absolutePath, fileData.content, { mode: fileData.executable ? 0o755 : 0o644 });
+
+          if (!options.silent) {
+            console.log(chalk.green(`✓ Installed additional file: ${relativePath}`));
+          }
+        }
+      }
+
       if (!options.silent) {
         console.log(chalk.green(`✅ Hook "${hookName}" installed successfully in ${installLocation}!`));
         console.log(chalk.cyan(`📁 Configuration merged into: ${actualTargetFile}`));

package/cli-tool/templates/common/.claude/commands/git-workflow.md

@@ -0,0 +1,239 @@
+# Git Workflow Helper
+
+Manage Git workflows with best practices and common operations.
+
+## Purpose
+
+This command helps you perform common Git operations following best practices for collaborative development.
+
+## Usage
+
+```
+/git-workflow
+```
+
+## What this command does
+
+1. **Guides through Git operations** with proper workflow
+2. **Suggests best practices** for commits and branches
+3. **Helps with conflict resolution** and merging
+4. **Provides templates** for commit messages
+5. **Manages branching strategies** (Git Flow, GitHub Flow)
+
+## Common Workflows
+
+### Feature Development
+```bash
+# Create and switch to feature branch
+git checkout -b feature/user-authentication
+
+# Work on your feature
+# ... make changes ...
+
+# Stage and commit changes
+git add .
+git commit -m "feat: add user authentication system
+
+- Implement login/logout functionality
+- Add password validation
+- Create user session management
+- Add authentication middleware"
+
+# Push feature branch
+git push -u origin feature/user-authentication
+
+# Create pull request (via GitHub/GitLab interface)
+```
+
+### Hotfix Workflow
+```bash
+# Create hotfix branch from main
+git checkout main
+git checkout -b hotfix/security-patch
+
+# Fix the issue
+# ... make changes ...
+
+# Commit the fix
+git commit -m "fix: resolve security vulnerability in auth module
+
+- Patch XSS vulnerability in login form
+- Update input validation
+- Add CSRF protection"
+
+# Push and create urgent PR
+git push -u origin hotfix/security-patch
+```
+
+### Sync with Remote
+```bash
+# Update main branch
+git checkout main
+git pull origin main
+
+# Update feature branch with latest main
+git checkout feature/your-feature
+git rebase main
+# OR
+git merge main
+```
+
+## Commit Message Conventions
+
+### Conventional Commits Format
+```
+<type>[optional scope]: <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+### Common Types
+- **feat**: New feature
+- **fix**: Bug fix
+- **docs**: Documentation changes
+- **style**: Code style changes (formatting, etc.)
+- **refactor**: Code refactoring
+- **test**: Adding or updating tests
+- **chore**: Maintenance tasks
+
+### Examples
+```bash
+# Feature
+git commit -m "feat(auth): add OAuth2 integration"
+
+# Bug fix
+git commit -m "fix(api): handle null response in user endpoint"
+
+# Documentation
+git commit -m "docs: update API documentation for v2.0"
+
+# Breaking change
+git commit -m "feat!: change API response format
+
+BREAKING CHANGE: API responses now use 'data' wrapper"
+```
+
+## Branch Management
+
+### Git Flow Strategy
+```bash
+# Main branches
+main        # Production-ready code
+develop     # Integration branch
+
+# Supporting branches
+feature/*   # New features
+release/*   # Release preparation
+hotfix/*    # Quick fixes to production
+```
+
+### GitHub Flow (Simplified)
+```bash
+# Only main branch + feature branches
+main        # Production-ready code
+feature/*   # All new work
+```
+
+## Conflict Resolution
+
+### When Conflicts Occur
+```bash
+# Start merge/rebase
+git merge feature-branch
+# OR
+git rebase main
+
+# If conflicts occur, Git will list conflicted files
+# Edit each file to resolve conflicts
+
+# Mark conflicts as resolved
+git add conflicted-file.js
+
+# Continue the merge/rebase
+git merge --continue
+# OR
+git rebase --continue
+```
+
+### Conflict Markers
+```javascript
+<<<<<<< HEAD
+// Your current branch code
+const user = getCurrentUser();
+=======
+// Incoming branch code
+const user = getAuthenticatedUser();
+>>>>>>> feature-branch
+```
+
+## Useful Git Commands
+
+### Status and Information
+```bash
+git status                    # Check working directory status
+git log --oneline            # View commit history
+git branch -a                # List all branches
+git remote -v                # List remote repositories
+```
+
+### Undoing Changes
+```bash
+git checkout -- file.js     # Discard changes to file
+git reset HEAD file.js       # Unstage file
+git reset --soft HEAD~1     # Undo last commit (keep changes)
+git reset --hard HEAD~1     # Undo last commit (discard changes)
+```
+
+### Stashing Work
+```bash
+git stash                    # Save current work
+git stash pop               # Apply and remove latest stash
+git stash list              # List all stashes
+git stash apply stash@{1}   # Apply specific stash
+```
+
+## Best Practices
+
+1. **Commit Often** - Make small, focused commits
+2. **Write Clear Messages** - Use conventional commit format
+3. **Test Before Committing** - Ensure code works
+4. **Pull Before Push** - Keep history clean
+5. **Use Branches** - Don't work directly on main
+6. **Review Code** - Use pull requests for collaboration
+7. **Keep History Clean** - Rebase feature branches when appropriate
+
+## Git Hooks (Optional)
+
+### Pre-commit Hook
+```bash
+#!/bin/sh
+# .git/hooks/pre-commit
+
+# Run linter
+npm run lint
+if [ $? -ne 0 ]; then
+  echo "Linting failed. Please fix errors before committing."
+  exit 1
+fi
+
+# Run tests
+npm test
+if [ $? -ne 0 ]; then
+  echo "Tests failed. Please fix tests before committing."
+  exit 1
+fi
+```
+
+### Commit Message Hook
+```bash
+#!/bin/sh
+# .git/hooks/commit-msg
+
+# Check commit message format
+if ! grep -qE "^(feat|fix|docs|style|refactor|test|chore)(\(.+\))?: .{1,50}" "$1"; then
+  echo "Invalid commit message format. Use conventional commits."
+  exit 1
+fi
+```

package/cli-tool/templates/common/.claude/commands/project-setup.md

@@ -0,0 +1,316 @@
+# Project Setup Helper
+
+Set up new projects with proper structure and best practices.
+
+## Purpose
+
+This command helps you set up new projects with proper directory structure, configuration files, and development environment.
+
+## Usage
+
+```
+/project-setup
+```
+
+## What this command does
+
+1. **Creates project structure** with standard directories
+2. **Sets up configuration files** (.gitignore, README, etc.)
+3. **Initializes version control** and development tools
+4. **Configures environment files** and dependencies
+5. **Follows language-specific** conventions and best practices
+
+## Project Structure Templates
+
+### Generic Project Structure
+```
+project-name/
+├── README.md                 # Project documentation
+├── .gitignore               # Git ignore rules
+├── .env.example             # Environment variables template
+├── LICENSE                  # Project license
+├── CHANGELOG.md             # Version history
+├── docs/                    # Documentation
+│   ├── API.md
+│   ├── CONTRIBUTING.md
+│   └── DEPLOYMENT.md
+├── src/                     # Source code
+│   ├── main/
+│   ├── utils/
+│   └── config/
+├── tests/                   # Test files
+│   ├── unit/
+│   ├── integration/
+│   └── fixtures/
+├── scripts/                 # Build and deployment scripts
+│   ├── build.sh
+│   ├── deploy.sh
+│   └── setup.sh
+└── config/                  # Configuration files
+    ├── development.yml
+    ├── production.yml
+    └── testing.yml
+```
+
+### Web Application Structure
+```
+web-app/
+├── public/                  # Static assets
+│   ├── index.html
+│   ├── favicon.ico
+│   └── assets/
+│       ├── css/
+│       ├── js/
+│       └── images/
+├── src/                     # Source code
+│   ├── components/          # Reusable components
+│   ├── pages/              # Page components
+│   ├── services/           # API services
+│   ├── utils/              # Utility functions
+│   ├── styles/             # Stylesheets
+│   └── config/             # Configuration
+├── tests/                   # Test files
+└── build/                   # Build output
+```
+
+### API Project Structure
+```
+api-project/
+├── src/
+│   ├── controllers/         # Request handlers
+│   ├── models/             # Data models
+│   ├── services/           # Business logic
+│   ├── middleware/         # Custom middleware
+│   ├── routes/             # API routes
+│   ├── utils/              # Utility functions
+│   └── config/             # Configuration
+├── tests/
+│   ├── unit/
+│   ├── integration/
+│   └── e2e/
+├── docs/
+│   ├── api-spec.yml        # OpenAPI specification
+│   └── README.md
+└── scripts/
+    ├── seed-db.js          # Database seeding
+    └── migrate.js          # Database migrations
+```
+
+## Essential Configuration Files
+
+### .gitignore Template
+```gitignore
+# Dependencies
+node_modules/
+*.log
+npm-debug.log*
+
+# Environment files
+.env
+.env.local
+.env.production
+
+# Build outputs
+dist/
+build/
+*.tgz
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Temporary files
+*.tmp
+*.temp
+```
+
+### README.md Template
+```markdown
+# Project Name
+
+Brief description of what this project does.
+
+## Features
+
+- Feature 1
+- Feature 2
+- Feature 3
+
+## Installation
+
+\`\`\`bash
+# Clone the repository
+git clone https://github.com/username/project-name.git
+
+# Install dependencies
+npm install
+
+# Copy environment file
+cp .env.example .env
+\`\`\`
+
+## Usage
+
+\`\`\`bash
+# Start development server
+npm run dev
+
+# Run tests
+npm test
+
+# Build for production
+npm run build
+\`\`\`
+
+## API Documentation
+
+[API documentation](docs/API.md)
+
+## Contributing
+
+Please read [CONTRIBUTING.md](docs/CONTRIBUTING.md) for details.
+
+## License
+
+This project is licensed under the MIT License - see [LICENSE](LICENSE) file.
+```
+
+### .env.example Template
+```env
+# Application
+NODE_ENV=development
+PORT=3000
+HOST=localhost
+
+# Database
+DB_HOST=localhost
+DB_PORT=5432
+DB_NAME=myapp
+DB_USER=username
+DB_PASSWORD=password
+
+# API Keys
+API_KEY=your-api-key-here
+SECRET_KEY=your-secret-key-here
+
+# External Services
+REDIS_URL=redis://localhost:6379
+EMAIL_SERVICE_API_KEY=your-email-key
+```
+
+## Development Environment Setup
+
+### Package.json Scripts
+```json
+{
+  "scripts": {
+    "start": "node src/index.js",
+    "dev": "nodemon src/index.js",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write src/",
+    "build": "webpack --mode production",
+    "build:dev": "webpack --mode development",
+    "clean": "rm -rf dist/"
+  }
+}
+```
+
+### Git Initialization
+```bash
+# Initialize Git repository
+git init
+
+# Add initial files
+git add .
+
+# Create initial commit
+git commit -m "feat: initial project setup
+
+- Add project structure
+- Configure development environment
+- Add documentation templates
+- Set up testing framework"
+
+# Add remote origin
+git remote add origin https://github.com/username/project-name.git
+
+# Push to remote
+git push -u origin main
+```
+
+## Language-Specific Setup
+
+### Node.js/JavaScript
+```bash
+npm init -y
+npm install --save-dev nodemon jest eslint prettier
+```
+
+### Python
+```bash
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+pip install -r requirements.txt
+```
+
+### Docker Setup
+```dockerfile
+# Dockerfile
+FROM node:16-alpine
+WORKDIR /app
+COPY package*.json ./
+RUN npm install
+COPY . .
+EXPOSE 3000
+CMD ["npm", "start"]
+```
+
+```yaml
+# docker-compose.yml
+version: '3.8'
+services:
+  app:
+    build: .
+    ports:
+      - "3000:3000"
+    environment:
+      - NODE_ENV=development
+    volumes:
+      - .:/app
+      - /app/node_modules
+```
+
+## Best Practices
+
+1. **Consistent Structure** - Follow established conventions
+2. **Clear Documentation** - Write comprehensive README
+3. **Environment Variables** - Keep secrets out of code
+4. **Version Control** - Initialize Git from the start
+5. **Testing Setup** - Configure testing from day one
+6. **Code Quality** - Set up linting and formatting
+7. **CI/CD Ready** - Structure for automated deployment
+8. **Security** - Include security best practices
+
+## Checklist
+
+- [ ] Create project directory structure
+- [ ] Initialize version control (Git)
+- [ ] Set up package manager (npm, pip, etc.)
+- [ ] Create README.md with project info
+- [ ] Add .gitignore file
+- [ ] Set up environment variables
+- [ ] Configure linting and formatting
+- [ ] Set up testing framework
+- [ ] Create basic documentation
+- [ ] Add license file
+- [ ] Set up CI/CD configuration (if needed)