build-app-with 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 New React App Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,240 @@
+# 🚀 New React App - Production-Grade Project Generator
+
+A powerful CLI tool that generates production-ready applications with modern frameworks, best practices, and comprehensive boilerplate code.
+
+## ✨ Features
+
+### 🎯 Supported Frameworks
+- **Next.js** - Full-stack React framework with App Router
+- **Vite + React** - Lightning-fast frontend development
+- **Express.js** - Production-ready Node.js backend
+- **Fastify** - High-performance Node.js backend
+
+### 🛠️ Production-Grade Features
+- **TypeScript Support** - Full TypeScript configuration
+- **Error Handling** - Comprehensive error handling and logging
+- **Security** - Helmet, CORS, rate limiting, input validation
+- **Database Integration** - MongoDB, PostgreSQL, MySQL, SQLite
+- **Authentication** - JWT, Sessions, OAuth strategies
+- **Testing** - Jest, Supertest, comprehensive test setup
+- **Docker Support** - Production-ready containerization
+- **Logging** - Winston logger with structured logging
+- **API Documentation** - Swagger/OpenAPI integration
+- **Code Quality** - ESLint, Prettier, Husky pre-commit hooks
+
+### 🎨 Frontend Features
+- **CSS Frameworks** - Tailwind, Bootstrap, MUI, Chakra UI, shadcn/ui
+- **State Management** - Redux Toolkit, Zustand, MobX, Recoil
+- **Data Fetching** - TanStack Query, Axios with interceptors
+- **Forms** - React Hook Form, Formik with validation
+- **Animations** - Framer Motion, React Spring
+- **UI Components** - Ant Design, Material-UI, Chakra UI
+- **Utilities** - React Icons, Toast notifications, i18n
+
+### 🔧 Backend Features
+- **Database ORMs** - Prisma, Mongoose, Sequelize
+- **Authentication** - JWT, Passport.js, NextAuth
+- **API Features** - tRPC, GraphQL support
+- **Middleware** - CORS, Helmet, Morgan, Rate limiting
+- **Validation** - Express Validator, Joi, Zod
+- **Documentation** - Swagger/OpenAPI auto-generation
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+# Install globally
+npm install -g build-app-with
+
+# Or use with npx
+npx build-app-with my-awesome-app
+```
+
+### Usage
+
+```bash
+# Start the interactive CLI
+build-app-with
+
+# Or specify project name directly
+build-app-with my-project
+```
+
+## 📁 Project Structure
+
+```
+src/
+├── core/                    # Core utilities
+│   ├── logger.js           # Centralized logging
+│   ├── error-handler.js    # Error handling
+│   └── package-manager.js  # Package management
+├── generators/             # Framework generators
+│   ├── nextjs/            # Next.js generator
+│   ├── vite/              # Vite + React generator
+│   ├── express/           # Express.js generator
+│   └── fastify/           # Fastify generator
+├── templates/             # Code templates
+├── config/                # Configuration files
+├── types/                 # Type definitions
+└── utils/                 # Utility functions
+```
+
+## 🎯 Framework-Specific Features
+
+### Next.js Generator
+- App Router and Pages Router support
+- Server-side rendering (SSR)
+- Static site generation (SSG)
+- API routes
+- Middleware support
+- Image optimization
+- Font optimization
+- Built-in TypeScript support
+
+### Vite + React Generator
+- Lightning-fast HMR
+- Multiple project structures
+- CSS framework integration
+- State management setup
+- Testing configuration
+- Build optimization
+
+### Express.js Generator
+- Modular architecture
+- Database integration
+- Authentication strategies
+- Middleware stack
+- Error handling
+- Logging configuration
+- API documentation
+- Docker support
+
+### Fastify Generator
+- Plugin-based architecture
+- High performance
+- Schema validation
+- TypeScript support
+- WebSocket support
+- GraphQL integration
+- Rate limiting
+- CORS configuration
+
+## 🔧 Configuration
+
+### Environment Variables
+
+Each generated project includes comprehensive environment configuration:
+
+```bash
+# Server Configuration
+PORT=3000
+NODE_ENV=development
+
+# Database Configuration
+DATABASE_URL=your_database_url
+MONGODB_URI=mongodb://localhost:27017/your_db
+
+# Authentication
+JWT_SECRET=your_jwt_secret
+JWT_EXPIRES_IN=7d
+
+# CORS
+CORS_ORIGIN=http://localhost:3000
+```
+
+### Package Manager Support
+
+- **npm** - Default package manager
+- **yarn** - Fast, reliable, and secure
+- **pnpm** - Efficient disk space usage
+
+## 🧪 Testing
+
+All generated projects include comprehensive testing setup:
+
+```bash
+# Run tests
+npm test
+
+# Run tests in watch mode
+npm run test:watch
+
+# Generate coverage report
+npm run test:coverage
+```
+
+## 🐳 Docker Support
+
+Production-ready Docker configuration:
+
+```bash
+# Build Docker image
+docker build -t my-app .
+
+# Run with Docker Compose
+docker-compose up -d
+```
+
+## 📚 Documentation
+
+Each generated project includes:
+- Comprehensive README
+- API documentation (Swagger)
+- Code comments and JSDoc
+- Architecture diagrams
+- Deployment guides
+
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+### Development Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/imnayakshubham/build-app-with.git
+
+# Install dependencies
+npm install
+
+# Run in development mode
+npm run dev
+
+# Run tests
+npm test
+```
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- **Next.js Team** - For the amazing React framework
+- **Vite Team** - For the lightning-fast build tool
+- **Express.js Team** - For the robust Node.js framework
+- **Fastify Team** - For the high-performance Node.js framework
+- **React Community** - For the incredible ecosystem
+
+## 📞 Support
+
+- 🐛 Issues: [GitHub Issues](https://github.com/imnayakshubham/build-app-with/issues)
+- 💬 Discussions: [GitHub Discussions](https://github.com/imnayakshubham/build-app-with/discussions)
+
+## 🚀 Roadmap
+
+- [ ] Vue.js support
+- [ ] Svelte support
+- [ ] Angular support
+- [ ] Microservices architecture
+- [ ] Kubernetes deployment
+- [ ] CI/CD pipeline templates
+- [ ] Monitoring and observability
+- [ ] Performance optimization tools
+
+---
+
+**Made with ❤️ by the [Create New App](https://github.com/imnayakshubham/build-app-with)**
+
+*Generate production-ready applications in seconds, not hours.*

package/bin/cli.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+
+import { createApp } from '../src/create-app.js';
+import { welcomeMessage } from '../src/utils/messages.js';
+import { logger } from '../src/core/logger.js';
+
+async function main() {
+  welcomeMessage();
+  await createApp();
+}
+
+main().catch((error) => {
+  logger.error(`Fatal error: ${error.message}`);
+  if (logger.isDevelopment) {
+    console.error(error.stack);
+  }
+  process.exit(1);
+});

package/index.js

@@ -0,0 +1,3 @@
+
+// run `node index.js` in the terminal
+console.log(`Hello Node.js v${process.versions.node}!`);

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "build-app-with",
+  "version": "2.0.0",
+  "description": "Production-grade CLI tool to create modern web applications with Next.js, Vite, Express, and Fastify",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "build-app-with": "./bin/cli.js"
+  },
+  "scripts": {
+    "start": "node ./bin/cli.js",
+    "dev": "node ./bin/cli.js",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src/ --ext .js,.ts",
+    "lint:fix": "eslint src/ --ext .js,.ts --fix",
+    "format": "prettier --write src/",
+    "build": "echo 'No build step required for CLI tool'",
+    "prepublishOnly": "npm run test:core && npm run lint",
+    "test:core": "jest --testPathPattern=core"
+  },
+  "keywords": [
+    "react",
+    "nextjs",
+    "vite",
+    "express",
+    "fastify",
+    "nodejs",
+    "cli",
+    "generator",
+    "scaffold",
+    "boilerplate",
+    "production-ready",
+    "typescript",
+    "fullstack"
+  ],
+  "author": "imnayakshubham",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/imnayakshubham/build-app-with.git"
+  },
+  "bugs": {
+    "url": "https://github.com/imnayakshubham/build-app-with/issues"
+  },
+  "homepage": "https://github.com/imnayakshubham/build-app-with#readme",
+  "dependencies": {
+    "chalk": "^5.6.0",
+    "execa": "^9.6.0",
+    "fs-extra": "^11.3.1",
+    "inquirer": "^8.2.6",
+    "ora": "^8.2.0"
+  },
+  "devDependencies": {
+    "jest": "^29.7.0",
+    "eslint": "^8.57.0",
+    "prettier": "^3.2.5",
+    "@types/jest": "^29.5.12",
+    "@babel/core": "^7.23.0",
+    "@babel/preset-env": "^7.23.0",
+    "@babel/plugin-transform-modules-commonjs": "^7.23.0",
+    "babel-jest": "^29.7.0"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=8.0.0"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "index.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "preferGlobal": true,
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/__tests__/core/error-handler.test.js

@@ -0,0 +1,99 @@
+/**
+ * Tests for error handler utility
+ */
+
+import {
+    ProjectGeneratorError,
+    ValidationError,
+    FileSystemError,
+    DependencyError,
+    validateProjectName,
+    validateFramework
+} from '../../core/error-handler.js';
+
+describe('Error Handler', () => {
+    describe('ProjectGeneratorError', () => {
+        it('should create error with message and code', () => {
+            const error = new ProjectGeneratorError('Test error', 'TEST_ERROR');
+            expect(error.message).toBe('Test error');
+            expect(error.code).toBe('TEST_ERROR');
+            expect(error.name).toBe('ProjectGeneratorError');
+        });
+
+        it('should create error with details', () => {
+            const error = new ProjectGeneratorError('Test error', 'TEST_ERROR', { field: 'test' });
+            expect(error.details).toEqual({ field: 'test' });
+        });
+    });
+
+    describe('ValidationError', () => {
+        it('should create validation error', () => {
+            const error = new ValidationError('Invalid input', 'projectName');
+            expect(error.message).toBe('Invalid input');
+            expect(error.code).toBe('VALIDATION_ERROR');
+            expect(error.name).toBe('ValidationError');
+            expect(error.details).toEqual({ field: 'projectName' });
+        });
+    });
+
+    describe('FileSystemError', () => {
+        it('should create file system error', () => {
+            const error = new FileSystemError('File not found', '/path/to/file');
+            expect(error.message).toBe('File not found');
+            expect(error.code).toBe('FILE_SYSTEM_ERROR');
+            expect(error.name).toBe('FileSystemError');
+            expect(error.details).toEqual({ path: '/path/to/file' });
+        });
+    });
+
+    describe('DependencyError', () => {
+        it('should create dependency error', () => {
+            const error = new DependencyError('Package not found', 'react');
+            expect(error.message).toBe('Package not found');
+            expect(error.code).toBe('DEPENDENCY_ERROR');
+            expect(error.name).toBe('DependencyError');
+            expect(error.details).toEqual({ packageName: 'react' });
+        });
+    });
+
+    describe('validateProjectName', () => {
+        it('should validate valid project name', () => {
+            expect(() => validateProjectName('my-app')).not.toThrow();
+            expect(() => validateProjectName('my_app')).not.toThrow();
+            expect(() => validateProjectName('my-app-123')).not.toThrow();
+        });
+
+        it('should throw error for invalid project name', () => {
+            expect(() => validateProjectName('')).toThrow(ValidationError);
+            expect(() => validateProjectName('my app')).toThrow(ValidationError);
+            expect(() => validateProjectName('my@app')).toThrow(ValidationError);
+            expect(() => validateProjectName('my.app')).toThrow(ValidationError);
+        });
+
+        it('should throw error for too long project name', () => {
+            const longName = 'a'.repeat(51);
+            expect(() => validateProjectName(longName)).toThrow(ValidationError);
+        });
+
+        it('should throw error for non-string input', () => {
+            expect(() => validateProjectName(null)).toThrow(ValidationError);
+            expect(() => validateProjectName(undefined)).toThrow(ValidationError);
+            expect(() => validateProjectName(123)).toThrow(ValidationError);
+        });
+    });
+
+    describe('validateFramework', () => {
+        it('should validate valid framework', () => {
+            expect(() => validateFramework('nextjs')).not.toThrow();
+            expect(() => validateFramework('vite-react')).not.toThrow();
+            expect(() => validateFramework('express')).not.toThrow();
+            expect(() => validateFramework('fastify')).not.toThrow();
+        });
+
+        it('should throw error for invalid framework', () => {
+            expect(() => validateFramework('invalid')).toThrow(ValidationError);
+            expect(() => validateFramework('')).toThrow(ValidationError);
+            expect(() => validateFramework(null)).toThrow(ValidationError);
+        });
+    });
+});

package/src/__tests__/core/logger.test.js

@@ -0,0 +1,93 @@
+/**
+ * Tests for logger utility
+ */
+
+import { logger } from '../../core/logger.js';
+
+describe('Logger', () => {
+    beforeEach(() => {
+        jest.clearAllMocks();
+    });
+
+    describe('info', () => {
+        it('should log info message', () => {
+            logger.info('Test info message');
+            expect(console.log).toHaveBeenCalledWith('ℹ', 'Test info message');
+        });
+    });
+
+    describe('success', () => {
+        it('should log success message', () => {
+            logger.success('Test success message');
+            expect(console.log).toHaveBeenCalledWith('✓', 'Test success message');
+        });
+    });
+
+    describe('warning', () => {
+        it('should log warning message', () => {
+            logger.warning('Test warning message');
+            expect(console.log).toHaveBeenCalledWith('⚠', 'Test warning message');
+        });
+    });
+
+    describe('error', () => {
+        it('should log error message', () => {
+            logger.error('Test error message');
+            expect(console.error).toHaveBeenCalledWith('✗', 'Test error message');
+        });
+    });
+
+    describe('startSpinner', () => {
+        it('should start spinner with message', () => {
+            const spinner = logger.startSpinner('Test spinner');
+            expect(spinner).toBeDefined();
+        });
+    });
+
+    describe('stopSpinner', () => {
+        it('should stop spinner with success', () => {
+            logger.startSpinner('Test spinner');
+            logger.stopSpinner(true, 'Success message');
+            // Spinner methods are mocked, so we just verify they don't throw
+        });
+
+        it('should stop spinner with failure', () => {
+            logger.startSpinner('Test spinner');
+            logger.stopSpinner(false, 'Error message');
+            // Spinner methods are mocked, so we just verify they don't throw
+        });
+    });
+
+    describe('logStep', () => {
+        it('should log step with progress', () => {
+            logger.logStep(1, 3, 'Test step');
+            expect(console.log).toHaveBeenCalledWith('[1/3]', 'Test step');
+        });
+    });
+
+    describe('logCommand', () => {
+        it('should log command when isDevelopment is true', () => {
+            // Mock the logger's isDevelopment property
+            logger.isDevelopment = true;
+            logger.isQuiet = false;
+
+            logger.logCommand('npm install');
+
+            // Check for chalk styled output
+            expect(console.log).toHaveBeenCalledWith('$', 'npm install');
+        });
+
+        it('should not log command when not in development', () => {
+            jest.clearAllMocks();
+
+            // Mock the logger's isDevelopment property
+            logger.isDevelopment = false;
+            logger.isQuiet = false;
+
+            logger.logCommand('npm install');
+
+            // Should not have been called
+            expect(console.log).not.toHaveBeenCalled();
+        });
+    });
+});