A CLI toolbelt to streamline local development cycles by using various gitzone utilities.
To install the @git.zone/cli
tool, you need to have Node.js and npm installed on your machine. Once you have those set up, you can install the CLI tool globally using the following command:
npm install -g @git.zone/cli
This will add the gitzone
or gzone
command to your PATH, allowing you to use the tool from any directory.
The gitzone
CLI is designed to streamline various aspects of the local development cycle, including project setup, maintenance, and deployment. Below, we'll go through several scenarios that demonstrate the capabilities of gitzone
.
To start using gitzone
, you need to initialize a new project or use it with an existing one. This section will guide you through the initial setup and provide examples of the core commands.
gitzone
can create several types of projects, including standard npm modules, websites using LitElement, and custom web components. To create a new project, you can use the following command:
gitzone template [templatename]
Replace [templatename]
with one of the following:
-
npm
: A standard npm module with TypeScript support, testing, and CI/CD setup. -
website
: A LitElement-based website with e2e testing, bundling, and service worker support. -
element
: A LitElement standard setup for creating web components.
Example of starting a new npm project:
- Open your terminal and navigate to the directory where you want to create your project.
- Execute the following command:
gitzone template npm
- Follow the interactive prompts to set up your project. You will be asked to provide information such as the project name, description, GitHub repository, etc.
To standardize commit messages and increment versions based on change types (fix, feat, breaking change):
gitzone commit
This command will prompt you with a series of questions to help construct a standardized commit message and create a new commit.
To deprecate an old package in favor of a new one:
gitzone deprecate
This command will prompt you for the old and new package names and will automatically deprecate the old package on npm.
Quickly open the CI/CD settings page of your project repository:
gitzone open ci
Let's go through how to scaffold a new web component project:
- Navigate to your desired directory.
- Run the following command:
gitzone template element
- Follow the prompts to set up your web component project.
Commands to manage your project's lifecycle:
-
Commit Changes:
gitzone commit
-
Deprecate a Package:
gitzone deprecate
-
Format Project Files:
gitzone format
-
Regenerate Readme:
gitzone readme
-
Update Local Repositories:
gitzone update
To ensure consistent formatting using Prettier:
gitzone format
To build your project as defined in your package.json
:
npm run build
Check the current project version:
gitzone -v
To synchronize local repositories with remotes:
gitzone update
To initialize or update metadata:
gitzone meta init
To execute tests defined in your package.json
:
npm test
Generate documentation:
npm run buildDocs
Enable detailed logging for troubleshooting:
gitzone --loglevel=debug
To clean up project artifacts:
gitzone clean
The gitzone
CLI tool provides a comprehensive suite of commands that streamline project setup, lifecycle management, and deployment, which are indispensable for modern development workflows. By familiarizing yourself with the different commands, you can maximize your productivity and focus on what really matters—writing code. Whether you are starting a new project, maintaining an existing one, or deploying your work, gitzone
is your toolbelt for efficient development cycles.
This repository contains open-source code that is licensed under the MIT License. A copy of the MIT License can be found in the license file within this repository.
Please note: The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.
This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH and are not included within the scope of the MIT license granted herein. Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines, and any usage must be approved in writing by Task Venture Capital GmbH.
Task Venture Capital GmbH
Registered at District court Bremen HRB 35230 HB, Germany
For any legal inquiries or if you require further information, please contact us via email at hello@task.vc.
By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.