# xTouch
[](https://www.npmjs.com/package/@xploration-tech/xtouch) [](https://www.npmjs.com/package/@xploration-tech/xtouch) [](<[](https://www.npmjs.com/package/@xploration-tech/xtouch)>) [](https://github.com/Xploration-Technologies/xtouch)
[](https://github.com/Xploration-Technologies/xtouch) [](https://github.com/Xploration-Technologies/xtouch) [](https://github.com/Xploration-Technologies/xtouch)
> The easiest way to create empty files and folder trees at a glance!
## Installation
```bash
> yarn global add @xploration-tech/xtouch
```
## Usage
xTouch is the easiest way to create new, empty files. It is also used to quickly create TypeScript projects and files from templates, based on our own preferences.
xTouch's syntax is
```bash
xtouch [option] file_name(s)
```
When used without any options, xTouch creates new files for any file names that are provided as arguments if files with such names do not already exist. xTouch can create any number of files simultaneously.
For example, the following command would create _four_ new, empty files named `tsconfig.json`, `tslint.json`, `index.ts`, and `package.json`.
```bash
xtouch tsconfig.json tslint.json index.ts package.json
```
As of 2.5.0 you can now add content per file!
```bash
xtouch file1 -c Contents! file2 -c "Multiple words must be in quotations" file3 -c 'More contents!'
```
### Addons
When used with options, xTouch creates new files based on the parameters given to it. xTouch cannot create more than one type of addon simultaneously. However, _should the need arise_, we will add it accordingly.
When creating project files, xTouch needs very few parameters to get you started. For example, the following command would create a _[Fusebox](https://fuse-box.org)_-powered module bundling file! The very same file that powers xTouch's bundles!
```bash
xtouch --addon fuse-box --type module.ts
```
You can also specify a name and path! In this example, xTouch will be replacing `__NAME__` with `83a9999ac29bb5ed086930699e307649`, simply a rather extreme example of a bundle name. xTouch will write the addon file into the `temp/` directory. By default, xTouch will simply write the addon into the CWD (Current Working Directory).
```bash
xtouch -a fuse-box -t module.ts -n 83a9999ac29bb5ed086930699e307649 --path temp
```
```diff
Sparky.task('default', () => {
...
- fuse.bundle('__NAME__').instructions('> xtouch.ts');
+ fuse.bundle('83a9999ac29bb5ed086930699e307649').instructions('> xtouch.ts');
});
```
Addons work by taking a file, renaming it, and putting it under a categoric folder. For example: `addons//`. Then we include a configuration file, and we're go for liftoff!
### Interactive `alpha` _Coming Soon\*_
When specifying the `--interactive` option, you'll be prompted with an interactive CLI for making your selections. This is only something we're playing around with, it may be buggy.
## Note
We're designing xTouch with modularity in mind. This means rather than simply creating a new project entirely, you can use xTouch to add files in a plugin-like way. Another features we're working on is resetting files. This way anything can be removed, reset, or added in a modular way, without you having to scroll through git commits for a good reset entry.