1.0.4 โ€ข Published 12 months ago

@canseyran/create-ts-cli-app v1.0.4

Weekly downloads
-
License
MIT
Repository
github
Last release
12 months ago

๐Ÿš€ Create TypeScript CLI App

Create TypeScript CLI App is a simple and efficient tool to set up a Node.js TypeScript project with minimal hassle. It comes pre-configured with essential tools and libraries, allowing you to focus on writing your code rather than setting up your environment.

โœจ Features

  • ๐Ÿ“ Single File Output: Webpack bundles your project into a single JavaScript file with a shebang (#!/usr/bin/env node). This allows for easy integration and sharing without needing to install npm packages.
  • ๐Ÿ”ท TypeScript: Ensures type safety and improves code quality.
  • ๐Ÿ” ESLint: Maintains code quality by identifying and fixing problems in your JavaScript code.
  • ๐Ÿ’… Prettier: Ensures consistent code formatting.
  • ๐Ÿงช Unit Testing: Set up with Vitest to ensure your code is tested and reliable.
  • ๐Ÿ› ๏ธ CLI Tools: Includes popular npm packages for creating CLI apps:
    • Chalk: For styling command-line output.
    • Commander: For parsing command-line arguments.
    • Inquirer: For creating interactive command-line prompts.

โš™๏ธ Prerequisites

  • Node.js: Version 20 or higher.

๐Ÿš€ Getting Started

To create a new project, run the following command:

npx @canseyran/create-ts-cli-app <project-directory>

Replace `` with your desired project folder name.

๐Ÿ› ๏ธ Example

npx @canseyran/create-ts-cli-app random-trivia-app
cd random-trivia-app
npm start

๐Ÿ“œ Available Commands

Once your project is set up, you can use the following npm scripts:

  • Start: Run the main TypeScript file.

    npm start
  • Build: Bundle your project into a single JavaScript file using Webpack.

    npm run build
  • Development Mode: Watch for changes and recompile automatically.

    npm run dev
  • Run Tests: Execute your unit tests with Vitest.

    npm test
  • Watch Tests: Run your tests in watch mode.

    npm run test:watch
  • Format Code: Format your code with Prettier.

    npm run format

๐Ÿ“‚ Project Structure

After setup, your project structure will look like this:

<project-directory>
โ”œโ”€โ”€ README.md
โ”œโ”€โ”€ eslint.config.mjs
โ”œโ”€โ”€ package.json
โ”œโ”€โ”€ src
โ”‚   โ”œโ”€โ”€ main.test.ts
โ”‚   โ””โ”€โ”€ main.ts
โ”œโ”€โ”€ tsconfig.json
โ”œโ”€โ”€ vitest.config.ts
โ””โ”€โ”€ webpack.config.js

๐Ÿค Contributing

Contributions are welcome! Please open an issue or submit a pull request for any changes or improvements.

๐Ÿ“„ License

This project is licensed under the MIT License.