sajjadmrx/neoX-cli

Cross typescript interfaces and types for microservice topologies!

🚀 neoX

📝 Description

neoX is a powerful CLI tool and library that aims to solve the problem of duplicated TypeScript interfaces and types across different codebases. By allowing you to create a centralized repository (public or private) with all your shared TypeScript definitions, you can easily manage and synchronize them in your projects. It even allows you to include a custom tsconfig.json for more advanced usage.

🛠 Installation

Local Installation

npm install neoX

or

yarn add neoX

Global Installation

Install neoX globally for system-wide accessibility.

npm install -g neoX

or

yarn global add neoX

⚡ Quick Start

After installing the package, use the CLI like so:

For local installation:

npx neoX init

For global installation:

neoX init

Or using the alias:

ct init

📘 Usage

CLI

Initialization

Run neoX init or its alias ct init to set up your centralized type repository.

neoX init

This creates a neoX.config.json in your current directory with recommended settings.

Pulling Types

To update your local type definitions from your centralized repository, run:

neoX pull

or its alias

ct pull

Advanced Usage: Custom tsconfig.json

neoX allows you to include a custom tsconfig.json in your centralized repository for advanced type management. To leverage this in your project, you can extend it like so:

{
  "extends": "./.neoX/tsconfig.json",
  // your custom overrides here
}

This gives you the freedom to set up paths, aliases, or any other TypeScript compiler options for the types you're pulling in.

Programmatic Use

neoX can also be integrated directly into your TypeScript projects. More documentation to come.

📦 API

init()

Initializes neoX, setting up a neoX.config.json in the current directory.

pull()

Updates your local type definitions from your centralized type repository.

📣 Contributing

1. Fork the repo (https://github.com/EternalC0der/neoX-cli/fork)
2. Create your feature branch (git checkout -b feature/fooBar)
3. Commit your changes (git commit -am 'Add some fooBar')
4. Push to the branch (git push origin feature/fooBar)
5. Create a new Pull Request

📝 License

MIT © EternalC0der