launchts 1.0.0

package/.husky/pre-commit

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+npx lint-staged

package/.prettierrc

@@ -0,0 +1,6 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "printWidth": 80
+}

package/CHANGELOG.md

@@ -0,0 +1,56 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2025-12-01
+
+### Added
+
+- **Interactive CLI** with prompts for tool selection
+- **Quick modes**: `--yes` (all tools) and `--default` (sensible defaults)
+- **Modern TypeScript config**: ESNext target, NodeNext modules with ESM
+- **Tool integrations**:
+  - ESLint with flat config (modern, non-deprecated)
+  - TypeScript ESLint v8+ (unified `typescript-eslint` package)
+  - Prettier with latest defaults (trailingComma: "all", printWidth: 80)
+  - Husky pre-commit hooks with lint-staged
+  - nodemon for dev auto-reload
+- **Auto-generated README.md**: Adapts to selected tools with usage instructions
+- **Git initialization** with optional first commit
+- **Package manager detection**: npm, yarn, pnpm
+- **Comprehensive test suite**: 39 tests with Vitest (unit, integration, e2e, messages)
+- **Complete documentation**: README and CONTRIBUTING guides
+- **CI/CD workflows**: GitHub Actions for quality checks and publishing
+- **Dynamic version resolution**: No hardcoded dependency versions
+- **Centralized messages**: All user-facing messages in `src/messages.ts` for maintainability
+
+### Features
+
+- Project scaffolding with configurable options
+- Smart defaults for rapid prototyping
+- Auto-format and lint staged files before commits
+- Type-safe configuration with strict TypeScript
+- Cross-platform support (Windows, macOS, Linux)
+- Parallel file I/O for optimal performance
+- Silent mode for check commands (no false error logs)
+
+### Developer Experience
+
+- Zero configuration needed to start
+- Sensible defaults that just work
+- Clear error messages and helpful tips
+- Fully tested and production-ready
+- Modern tooling and best practices (2024-2025)
+
+### Code Quality
+
+- **Modular architecture**: README generation split into 6 focused functions
+- **Type safety**: Strict TypeScript with no implicit `any` types
+- **Performance optimized**: Parallel I/O operations (Promise.all)
+- **Clean codebase**: No dead code, all imports used
+- **Comprehensive testing**: Unit tests for messages, E2E workflows, edge cases
+
+[1.0.0]: https://github.com/Jszigeti/launchts/releases/tag/v1.0.0

package/CONTRIBUTING.md

@@ -0,0 +1,280 @@
+# Contributing to launchts
+
+Thank you for your interest in contributing!
+
+## Quick Start
+
+1. **Fork and clone** the repository:
+
+   ```bash
+   git clone https://github.com/Jszigeti/launchts.git
+   cd launchts
+   ```
+
+2. **Install dependencies:**
+
+   ```bash
+   npm install
+   ```
+
+3. **Run tests:**
+
+   ```bash
+   npm test
+   ```
+
+4. **Try the CLI locally:**
+   ```bash
+   npm run dev -- my-test-project
+   # or build and link
+   npm run build
+   npm link
+   launchts my-test-project
+   ```
+
+---
+
+## Development Workflow
+
+### Project Structure
+
+```
+src/
+├── cli.ts           # CLI entry point, command parsing, prompts
+├── generator.ts     # Core project generation logic
+├── configs.ts       # Tool configurations (ESLint, Prettier, etc.)
+├── messages.ts      # Centralized user-facing messages
+└── types.ts         # TypeScript type definitions
+
+tests/
+├── cli.integration.test.ts    # CLI integration tests
+├── flags.test.ts              # Flag parsing tests
+├── generator.test.ts          # Generator unit tests
+├── generator.error.test.ts    # Error handling tests
+├── options.test.ts            # Tool injection tests
+└── validation.test.ts         # Input validation tests
+```
+
+### Available Scripts
+
+| Command             | Description                   |
+| ------------------- | ----------------------------- |
+| `npm run build`     | Compile TypeScript to `dist/` |
+| `npm run dev`       | Run CLI directly with ts-node |
+| `npm test`          | Run tests in watch mode       |
+| `npm test -- --run` | Run tests once (CI mode)      |
+| `npm run lint`      | Check for linting errors      |
+| `npm run format`    | Format code with Prettier     |
+
+---
+
+## Testing Guidelines
+
+### Writing Tests
+
+All new features **must** include tests. We use [Vitest](https://vitest.dev/) for testing.
+
+**Test categories:**
+
+- **Unit tests** — Test individual functions in isolation
+- **Integration tests** — Test CLI flows end-to-end
+- **Error tests** — Verify error handling and edge cases
+
+**Example test:**
+
+```typescript
+import { describe, it, expect } from 'vitest';
+import { createProject } from '../src/generator';
+
+describe('myFeature', () => {
+  it('should do something specific', async () => {
+    // Arrange
+    const options = { name: 'test-project' };
+
+    // Act
+    await createProject(options);
+
+    // Assert
+    expect(result).toBe(expected);
+  });
+});
+```
+
+### Running Tests
+
+```bash
+# Watch mode (default)
+npm test
+
+# Run once (CI)
+npm test -- --run
+
+# Run specific test file
+npm test -- generator.test.ts
+
+# Run with coverage
+npm test -- --coverage
+```
+
+---
+
+## Code Style
+
+We use **ESLint** and **Prettier** to maintain consistent code style.
+
+### Before Committing
+
+Run these commands to ensure your code passes CI:
+
+```bash
+npm run lint      # Check for linting errors
+npm run format    # Auto-format code
+npm test -- --run # Run all tests
+```
+
+### Pre-commit Hooks
+
+If you have Husky installed, these checks run automatically on commit. If not:
+
+```bash
+npm run prepare  # Install Git hooks
+```
+
+### Style Guidelines
+
+- **TypeScript:** Strict mode enabled, no `any` types
+- **Imports:** Use absolute paths from `src/`
+- **Functions:** Prefer named exports
+- **Comments:** Use JSDoc for public APIs
+- **Errors:** Use descriptive error messages with actionable tips
+
+---
+
+## Contribution Ideas
+
+### Good First Issues
+
+Look for issues labeled [`good first issue`](https://github.com/Jszigeti/launchts/labels/good%20first%20issue) — these are great for newcomers!
+
+### Areas to Improve
+
+- **New tools:** Add support for more dev tools (Jest, Vitest, etc.)
+- **Templates:** Add project templates (Express, CLI, library)
+- **Config options:** Expose more customization options
+- **Documentation:** Improve examples, add tutorials
+- **Performance:** Optimize file I/O, parallel operations
+- **Error messages:** Better error handling with helpful tips
+
+---
+
+## Pull Request Process
+
+1. **Create a branch:**
+
+   ```bash
+   git checkout -b feature/my-awesome-feature
+   ```
+
+2. **Make your changes:**
+   - Write code
+   - Add/update tests
+   - Update documentation if needed
+
+3. **Verify everything works:**
+
+   ```bash
+   npm run lint
+   npm run format
+   npm test -- --run
+   npm run build
+   ```
+
+4. **Commit with a clear message:**
+
+   ```bash
+   git commit -m "feat: add support for Jest"
+   ```
+
+   Use [conventional commits](https://www.conventionalcommits.org/):
+   - `feat:` New feature
+   - `fix:` Bug fix
+   - `docs:` Documentation changes
+   - `test:` Test changes
+   - `refactor:` Code refactoring
+   - `chore:` Maintenance tasks
+
+5. **Push and create PR:**
+
+   ```bash
+   git push origin feature/my-awesome-feature
+   ```
+
+   Then open a Pull Request on GitHub with:
+   - Clear description of changes
+   - Link to related issues
+   - Screenshots/examples if applicable
+
+6. **Respond to feedback:**
+   - Address review comments
+   - Keep the PR focused and small
+
+---
+
+## Reporting Bugs
+
+Found a bug? [Open an issue](https://github.com/Jszigeti/launchts/issues/new) with:
+
+- **Title:** Clear, descriptive summary
+- **Description:** What happened vs. what you expected
+- **Steps to reproduce:** Minimal example to trigger the bug
+- **Environment:** Node version, OS, package manager
+- **Logs:** Any error messages or stack traces
+
+**Example:**
+
+```markdown
+**Bug:** ESLint config not created when using --eslint
+
+**Steps:**
+
+1. Run `npx launchts my-app --eslint`
+2. Check for `.eslintrc.json`
+
+**Expected:** `.eslintrc.json` should exist
+**Actual:** File is missing
+
+**Environment:**
+
+- Node: v20.10.0
+- npm: 10.2.3
+- OS: macOS 14.1
+```
+
+---
+
+## Feature Requests
+
+Have an idea? [Open a discussion](https://github.com/Jszigeti/launchts/discussions/new) or issue with:
+
+- **Use case:** What problem does it solve?
+- **Proposed solution:** How should it work?
+- **Alternatives:** Other approaches you considered
+- **Examples:** Similar features in other tools
+
+---
+
+## Code of Conduct
+
+Be respectful, inclusive, and constructive. We're all here to build something great together!
+
+---
+
+## Recognition
+
+Contributors are recognized in:
+
+- Release notes
+- GitHub contributors page
+- Special shoutouts for significant contributions
+
+Thank you for making `launchts` better! ❤️

package/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2025 Jonas Szigeti
+
+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 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,304 @@
+# launchts
+
+[![npm version](https://img.shields.io/npm/v/launchts.svg)](https://www.npmjs.com/package/launchts)
+[![npm downloads](https://img.shields.io/npm/dm/launchts.svg)](https://www.npmjs.com/package/launchts)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CI](https://github.com/Jszigeti/launchts/actions/workflows/ci.yml/badge.svg)](https://github.com/Jszigeti/launchts/actions/workflows/ci.yml)
+
+**Fast, interactive CLI to scaffold production-ready TypeScript projects.**
+
+Inspired by Vite's developer experience, `launchts` gets you from zero to coding in seconds with optional tooling, sensible defaults, and zero configuration.
+
+---
+
+## Quick Start
+
+```bash
+# Interactive mode (recommended)
+npx launchts my-app
+
+# Skip all prompts with sensible defaults
+npx launchts my-app --default
+
+# Enable everything instantly
+npx launchts my-app --yes
+```
+
+That's it! Your TypeScript project is ready. Run `cd my-app && npm run dev` to start coding.
+
+---
+
+## Features
+
+- **Zero Config** — Start coding immediately with TypeScript configured
+- **Interactive Prompts** — Choose what you need (ESLint, Prettier, Husky, nodemon)
+- **Smart Detection** — Auto-detects your package manager (npm/yarn/pnpm)
+- **Optional Tooling** — Add linting, formatting, and git hooks on demand
+- **Git Ready** — Optional git initialization with first commit
+- **Battle Tested** — Comprehensive test suite with 39 passing tests
+
+---
+
+## Usage
+
+### Interactive Mode
+
+Simply run the command and answer the prompts:
+
+```bash
+npx launchts my-project
+```
+
+You'll be asked about:
+
+- **ESLint** — TypeScript linting with recommended rules
+- **Prettier** — Code formatting with opinionated defaults
+- **Husky** — Pre-commit hooks with lint-staged
+- **nodemon** — Auto-reload dev script with ts-node
+- **Git** — Initialize repository with .gitignore
+- **Install** — Run `npm install` automatically
+
+### Quick Modes
+
+**Use sensible defaults** (Prettier only, git + install):
+
+```bash
+npx launchts my-app --default
+# or
+npx launchts my-app -d
+```
+
+**Enable everything** (all tools: ESLint + Prettier + Husky + nodemon + git + install):
+
+```bash
+npx launchts my-app --yes
+# or
+npx launchts my-app -y
+```
+
+### Custom Configuration
+
+Mix and match options for your perfect setup:
+
+```bash
+# Minimal: just TypeScript
+npx launchts my-app --no-git --no-install
+
+# Linting only
+npx launchts my-app --eslint --prettier
+
+# Full stack with specific package manager
+npx launchts my-app --eslint --prettier --husky --nodemon --pm pnpm
+
+# Git without initial commit
+npx launchts my-app --git --no-commit
+```
+
+---
+
+## CLI Options
+
+### Flags
+
+| Flag           | Alias | Description                                                          | Default     |
+| -------------- | ----- | -------------------------------------------------------------------- | ----------- |
+| `--yes`        | `-y`  | Enable all tools (ESLint + Prettier + Husky + nodemon), skip prompts | `false`     |
+| `--default`    | `-d`  | Use sensible defaults (Prettier only), skip prompts                  | `false`     |
+| `--eslint`     |       | Add ESLint with TypeScript config                                    | interactive |
+| `--prettier`   |       | Add Prettier code formatter                                          | interactive |
+| `--husky`      |       | Add Husky pre-commit hooks                                           | interactive |
+| `--nodemon`    |       | Add nodemon dev script                                               | interactive |
+| `--git`        |       | Initialize git repository                                            | `true`\*    |
+| `--no-git`     |       | Skip git initialization                                              |             |
+| `--install`    |       | Install dependencies                                                 | `true`\*    |
+| `--no-install` |       | Skip dependency installation                                         |             |
+| `--no-commit`  |       | Skip initial git commit (when git enabled)                           | `false`     |
+| `--pm <name>`  |       | Package manager: npm, yarn, or pnpm                                  | auto-detect |
+| `--verbose`    |       | Show detailed command output                                         | `false`     |
+
+\* _In interactive mode, you'll be asked. In non-interactive mode (`--yes`/`--default`), defaults to `true`._
+
+### Package Manager
+
+The CLI auto-detects your package manager based on:
+
+1. The `npm_config_user_agent` environment variable
+2. Lockfiles in the current directory (`pnpm-lock.yaml`, `yarn.lock`, `package-lock.json`)
+3. Falls back to `npm`
+
+Override detection:
+
+```bash
+npx launchts my-app --pm yarn
+npx launchts my-app --pm pnpm
+```
+
+---
+
+## What You Get
+
+### Base Project Structure
+
+Every project includes:
+
+```
+my-app/
+├── src/
+│   └── index.ts          # Entry point with "Hello TypeScript"
+├── package.json          # With scripts and metadata
+├── tsconfig.json         # Sensible TypeScript config (ESNext, strict)
+└── .gitignore            # (if --git) Ignores node_modules, dist, .env
+```
+
+**Scripts included:**
+
+- `npm run build` — Compile TypeScript to `dist/`
+- `npm start` — Run compiled code from `dist/index.js`
+
+### With ESLint (`--eslint`)
+
+Adds TypeScript linting with best practices:
+
+```
+my-app/
+├── eslint.config.js      # Modern flat config with TypeScript support
+└── package.json          # + eslint dependencies
+```
+
+**Additional scripts:**
+
+- `npm run lint` — Check for linting errors
+
+**Packages:**
+
+- `eslint`
+- `@eslint/js`
+- `typescript-eslint` (unified package)
+- `globals`
+- `eslint-config-prettier` (if Prettier also enabled)
+
+### With Prettier (`--prettier`)
+
+Adds code formatting with opinionated defaults:
+
+```
+my-app/
+├── .prettierrc           # Config: semi, singleQuote, trailingComma
+└── package.json          # + prettier dependency
+```
+
+**Additional scripts:**
+
+- `npm run format` — Format all files
+
+**Configuration:**
+
+```json
+{
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "printWidth": 80
+}
+```
+
+### With Husky (`--husky`)
+
+Adds Git hooks for quality control:
+
+```
+my-app/
+├── .husky/
+│   └── pre-commit        # Runs lint-staged before commits
+└── package.json          # + husky, lint-staged config
+```
+
+**Additional scripts:**
+
+- `npm run prepare` — Install Git hooks
+
+**Behavior:**
+
+- Automatically runs `eslint --fix` and `prettier --write` on staged `.ts` files
+- Formats staged `.json` files with Prettier
+
+### With nodemon (`--nodemon`)
+
+Adds development auto-reload:
+
+**Additional scripts:**
+
+- `npm run dev` — Watch `src/` and auto-restart on changes
+
+**Packages:**
+
+- `nodemon`
+- `ts-node`
+
+---
+
+## Requirements
+
+- **Node.js** 18.0.0 or higher
+- **npm** 7+ (or **yarn** 1.22+, **pnpm** 7+)
+
+---
+
+## Examples
+
+### Minimal TypeScript Project
+
+```bash
+npx launchts my-app --no-git --no-install
+cd my-app
+npm install
+npm run build
+npm start
+```
+
+### Full Stack with Code Quality
+
+```bash
+npx launchts my-api --eslint --prettier --husky --nodemon
+cd my-api
+npm run dev  # Start coding with auto-reload
+```
+
+### Quick Prototype
+
+```bash
+npx launchts prototype -y
+cd prototype
+npm run dev
+```
+
+### Monorepo Package
+
+```bash
+cd my-monorepo/packages
+npx launchts new-package --no-git --pm pnpm
+```
+
+---
+
+## Contributing
+
+Contributions are welcome! See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
+
+---
+
+## License
+
+MIT © [Jonas](https://github.com/Jszigeti)
+
+---
+
+## Issues & Support
+
+- **Bug reports:** [Open an issue](https://github.com/Jszigeti/launchts/issues)
+- **Questions:** [GitHub Discussions](https://github.com/Jszigeti/launchts/discussions)
+- **Star the repo** if you find it useful!
+
+---
+
+**Made with ❤️ for the TypeScript community**

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};