Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat: beautify readme #166

Merged
merged 10 commits into from
Aug 27, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
## Contributing Guide

work in progress
105 changes: 89 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,43 +1,116 @@
# Zerops zCLI
![Zerops](https://github.com/zeropsio/recipe-shared-assets/blob/main/covers/svg/cover-zcli.svg)

Zerops zCLI is a command line utility for working with [zerops.io](https://zerops.io). It's used
for **CI/CD** development and CLI lovers.
<h2 align="center">
Zerops zCLI
<br/>
<br/>
</h2>

<p align="center">
<br/>
A <b>Command Line Utility / Command Line Interface</b> used for interacting with <a href="https://zerops.io/" target="_blank">Zerops</a> platform.
<br/>
</p>

<p align="center">
<b>Made with</b> ❤️ for <b>CI/CD</b> development and <b>CLI</b> lovers.
<br/>
</p>

<br />

<div align="center">

[![CI](https://github.com/zeropsio/zcli/actions/workflows/main.yml/badge.svg)](https://github.com/zeropsio/zcli/actions/workflows/ci.yml)
[![NPM Downloads](https://img.shields.io/npm/d18m/%40zerops%2Fzcli)](https://www.npmjs.com/package/@zerops/zcli)
[![npm version](https://badge.fury.io/js/@zerops%2Fzcli.svg)](https://badge.fury.io/js/@zerops%2Fzcli)
[![Discord](https://img.shields.io/discord/735781031147208777)](https://discord.gg/xxzmJSDKPT)
[![npm bundle size](https://img.shields.io/bundlephobia/min/%40zerops%2Fzcli)](https://www.npmjs.com/package/@zerops/zcli)

</div>

<br/>

<h3 align="end">
<a href="https://docs.zerops.io/" target="_blank">Read the docs →</a>
<br/>
</h3>

## Supported platforms

* Windows
* Linux
* MacOS (arm64, amd64)
- Windows
- Linux
- MacOS (arm64, amd64)
- NixOS

## Requirements

* [wireguard](https://www.wireguard.com)
- [Wireguard](https://www.wireguard.com/install/) - utilized by `zcli vpn` command.

## Install zCLI

### Package managers

#### Npm

```sh
npm i -g @zerops/zcli
```

### Windows
Execute following command in PowerShell

Execute following command in PowerShell:

```powershell
irm https://zerops.io/zcli/install.ps1 | iex
```

### Linux/MacOS
Execute following command in Terminal

Execute following command in Terminal:

```shell
curl -L https://zerops.io/zcli/install.sh | sh
```

### Package managers
### NixOS

#### Npm
- Clone this repository
- `cd zcli` into the root of the cloned repository and run `nix develop`.
- Run `nix build` to build the binary / execuetable of zCli.
- zCLI's binary / execuetable will be present in `./result/bin/zcli`.

Currently, the zCLI is distributed for Linux (x86 & x64 architecture), macOS (x64 & M1 architecture) and Windows (x64 architecture).

> [!TIP]
> To download the zCLI directly, use the [latest release](https://github.com/zeropsio/zcli/releases/latest/) on GitHub.

## Quick Start

- Create a new personal access token from [settings/token-management](http://app.zerops.io/settings/token-management).

- Login to zCLI using the personal access token using the following command:

```Shell
zcli login <token>
```
npm i -g @zerops/zcli

- Push your project using the following command:

```Shell
zcli push
```

Currently, the zCLI is distributed for Linux (x86 & x64 architecture), macOS (x64 & M1 architecture) and Windows (x64 architecture).

To download the zCLI directly, use the [latest release](https://github.com/zeropsio/zcli/releases/latest/) on GitHub.
## Additional Documentation

For more information go through https://docs.zerops.io/references/cli.

## Want to Contribute?

Contributions to zCLI are welcome and highly appreciated. However, We would like you to go through [CONTRIBUTING.md](https://github.com/zeropsio/zcli/blob/main/CONTRIBUTING.md).

## Community

## Additional documentation
To chat with other community members, you can join the [Zerops Discord Server](https://discord.gg/xxzmJSDKPT).

https://docs.zerops.io/references/cli
82 changes: 82 additions & 0 deletions tools/npm/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,82 @@
![Zerops](https://github.com/zeropsio/recipe-shared-assets/blob/main/covers/svg/cover-zcli.svg)

<h2 align="center">
Zerops zCLI
<br/>
<br/>
</h2>

<p align="center">
<br/>
A <b>Command Line Utility / Command Line Interface</b> used for interacting with <a href="https://zerops.io/" target="_blank">Zerops</a> platform.
<br/>
</p>

<p align="center">
<b>Made with</b> ❤️ for <b>CI/CD</b> development and <b>CLI</b> lovers.
<br/>
</p>

<br />

<div align="center">

[![CI](https://github.com/zeropsio/zcli/actions/workflows/main.yml/badge.svg)](https://github.com/zeropsio/zcli/actions/workflows/ci.yml)
[![NPM Downloads](https://img.shields.io/npm/d18m/%40zerops%2Fzcli)](https://www.npmjs.com/package/@zerops/zcli)
[![npm version](https://badge.fury.io/js/@zerops%2Fzcli.svg)](https://badge.fury.io/js/@zerops%2Fzcli)
[![Discord](https://img.shields.io/discord/735781031147208777)](https://discord.gg/xxzmJSDKPT)
[![npm bundle size](https://img.shields.io/bundlephobia/min/%40zerops%2Fzcli)](https://www.npmjs.com/package/@zerops/zcli)

</div>

<br/>

<h3 align="end">
<a href="https://docs.zerops.io/" target="_blank">Read the docs →</a>
<br/>
</h3>

## Install

```sh
npm i -g @zerops/zcli
```

Check out more installation ways at [zeropsio/zcli](https://github.com/zeropsio/zcli).

[!TIP]
> To download the zCLI directly, use the [latest release](https://github.com/zeropsio/zcli/releases/latest/) on GitHub.

## Requirements

- [Wireguard](https://www.wireguard.com/install/) - utilized by `zcli vpn` command.

## Quick Start

- Create a new personal access token from [settings/token-management](http://app.zerops.io/settings/token-management).

- Login to zCLI using the personal access token using the following command:

```Shell
zcli login <token>
```

- Push your project using the following command:

```Shell
zcli push
```

## Support

Having trouble? Get help in the official [Zerops Discord Server](https://discord.gg/xxzmJSDKPT).


## Additional Documentation

For more information go through [zCLI Documentation](https://docs.zerops.io/references/cli).

## Want to Contribute?

Contributions to zCLI are welcome and highly appreciated. However, We would like you to go through [CONTRIBUTING.md](https://github.com/zeropsio/zcli/blob/main/CONTRIBUTING.md).

4 changes: 3 additions & 1 deletion tools/npm/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
{
"name": "@zerops/zcli",
"version": "v0.0.0-zerops",
"description": "The command-line interface used for interacting with Zerops Platform.",
"main": "./utils/binary.js",
"license": "MIT",
"private": false,
Expand All @@ -18,7 +19,8 @@
},
"files": [
"/utils",
"package.json"
"package.json",
"README.md"
],
"scripts": {
"postinstall": "node ./utils/install.js",
Expand Down
Loading