repo-setup-cli
v1.0.0
Published
Initialize new project repositories with best-practice configurations
Maintainers
Readme
repo-setup-cli
A CLI tool to initialize new project repositories with best-practice configurations — git hooks, CI pipelines, linting, formatting, and more.
Installation
npm install -g repo-setup-cliOr use directly with npx:
npx repo-setup-cliUsage
Interactive wizard
Run without arguments to get an interactive prompt:
repo-setupPresets
Initialize with a specific preset non-interactively:
# Node.js + TypeScript
repo-setup --preset node-ts
# React + TypeScript
repo-setup --preset react-tsOptions
| Flag | Description |
|------|-------------|
| --preset <name> | Skip interactive mode: node-ts or react-ts |
| --license <type> | License: MIT (default), Apache-2.0, GPL-3.0, None |
| --no-ci | Skip GitHub Actions CI workflow |
| --dry-run | Preview what would be created without writing |
| --force | Overwrite existing files |
Examples
# Dry run to preview output
repo-setup --preset node-ts --dry-run
# React project without CI
repo-setup --preset react-ts --no-ci
# Force overwrite existing configs
repo-setup --preset node-ts --force
# MIT license explicitly
repo-setup --preset node-ts --license MITGenerated Files
| File | Description |
|------|-------------|
| .editorconfig | Editor settings (indent, line endings) |
| .gitattributes | Git line-ending normalization |
| .prettierrc | Prettier formatting config |
| .eslintrc.json | ESLint with TypeScript support |
| .gitignore | Stack-specific ignore patterns |
| LICENSE | MIT license (or chosen license) |
| CONTRIBUTING.md | Contribution guidelines template |
| .github/workflows/ci.yml | GitHub Actions CI (lint, typecheck, build) |
Presets
node-ts
Node.js + TypeScript project. ESLint config targets Node environment.
react-ts
React + TypeScript project. ESLint config includes React and React Hooks plugins.
Safe by Default
- Won't overwrite existing files unless
--forceis passed - Dry run mode lets you preview everything before committing
Development
git clone https://github.com/okirmio-create/repo-setup-cli
cd repo-setup-cli
npm install
npm run build
npm link
repo-setup --helpLicense
MIT © okirmio-create
