blue-cli 0.0.1

Fast and extensible workspace manager
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

<div align="center">
  <img alt="Logo" height="128" width="128" src=".github/blue.png"/>
</div>

<h1 align="center">Blue</h1>

<h4 align="center">
  Fast and extensible workspace manager
</h3>

<div align="center">
  <a href="https://github.com/slekup/blue/actions"><img src="https://github.com/slekup/blue/actions/workflows/tests.yaml/badge.svg?branch=main" alt="Tests Status" /></a>
  <a href="https://github.com/slekup/blue/releases"><img src="https://img.shields.io/github/v/tag/slekup/blue?label=Release" alt="Latest Release" /></a>
  <a href="https://www.rust-lang.org/"><img src="https://img.shields.io/badge/Made%20with-Rust-1f425f.svg" alt="Made with Rust"></a>
  <a href="hhttps://github.com/slekup/blue/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-GPL--3.0-9954ED.svg" alt="License: BY-NC-SA SA 4.0" /></a>
  <a href="https://github.com/slekup/blue/"><img src="https://img.shields.io/github/stars/slekup/blue?color=D500D5" alt="Github Repo Stars" /></a>
  <h4>
    <a href="https://blue.slekup.com">Documentation</a> ยท <a href="https://github.com/slekup/blue/blob/main/CHANGELOG.md">Changelog</a>
  </h4>
</div>

<br/>

Fast and extensible workspace manager written in Rust:

- **Fast:** Written in Rust with performance in mind.
- **Extensible:** Supports custom scripts and plugins.
- **Cross-platform:** Supports Windows, Linux, and macOS.
- **Private:** Blue doesn't collect any data.

## Features


Improve the DX (Developer Experience) of your workspace. Blue can help you with:

- **Workspace setup:** Automatically install dependencies, tools, and extensions.
- **Environment variables:** Create environment templates and delegate variables to projects from a single source file.
- **Maintenance:** Update dependencies, languages, package managers, and more with a single command.
- **Configuration:** Use presets for common build, test, and deployment scenarios and enforce consistent file extensions.
- **Customization:** Developers can override workspace settings with their own preferences.
- **Clean-up:** Manually or automatically delete temporary files and folders.
- **Environment Checks:** Ensure your workspace is set up correctly.
- **Project Management:** Create, delete, and manage projects easily.
- **Conventional Commits:** Utilize Git hooks to enforce conventional commits.
- **Custom Scripts:** Add custom scripts to be run with Git Bash.
- **GitHub:** Ensure your repository is compliant with GitHub's best practices.
- **Docker Management:** Manage your Docker containers and images with ease.
- **Reusability:** Create reusable workspace and project templates and publish them to GitHub.
- **Analytics:** Gain valuable insight into your workspace.

## Getting Started


> [!CAUTION]
> This project is still in development, don't expect any of the features to work. I (Slekup) also don't have a macOS device to test on, so macOS support is not guaranteed. If you want to help with macOS support, that would be greatly appreciated.

Visit [blue.slekup.com](https://blue.slekup.com) to get started with Blue.

## Contributing


We welcome contributions from everyone! Please read our [Contributing Guidelines](./CONTRIBUTING.md) for more details.

## License


This project is licensed under the [GPL-3.0](./LICENSE) license.

## Contact


If you have any questions or need further assistance, feel free to contact the project maintainer or open an issue in this repository.

## Reference


- [Code of Conduct](./CODE_OF_CONDUCT.md)
- [Changelog](./CHANGELOG.md)
- [Contributing](./CONTRIBUTING.md)