# Holistic Toolbox
A collection of useful tools, to service all areas of development. Hosted at https://holistic-toolbox.com

Check [.project/analytics.md](/.project/analytics.md) for analytics information

## Contents

### Tools
To see the list of tools, navigate to the [`tools`](/tools) folder.

### Home
Our landing page can be found in the [`website`](/website) folder.

### Layout
The Vue component library behind these UIs can be found at [`layout`](/layout).

### Automation
We have some automated workflows that run in this repo. They can be found in [`.github/workflows`](/.github/workflows).

## Contributing
Contributions are very welcome, just raise an issue / open a pull request! Ideas and implementations on [.project/tool-ideas.md](/.project/tool-ideas.md) are very welcome.

### Running Tools Locally
All tools can be run from this folder, thanks to [Lerna](https://github.com/lerna/lerna). To get set up:

Install Lerna and shared dependencies
```bash
npm install
```

Ensure all tools have unique dependencies available
```bash
npm run bootstrap
```

Run the tool with one of the following
```
npm run website
npm run layout
npm run tool-{{tool-name}}
```
Where `{{tool-name}}` is the tool to run, i.e. `npm run tool-json-formatter`.

### Creating a new tool
See [`.project/scripts/new-tool-script`](.project/scripts/new-tool-script) to generate a new tool for the toolbox. If you're looking for inspiration, check out: .project/tool-ideas.

### Roadmap
- Add a menu to the tools layout linking to other tools (when we have them)
- Improve mobile usability of each of our tools and our main website
- Fix up issues with the favicon rendering inconsistently