Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nuxt-hub/cli

Build full-stack Nuxt application with NuxtHub command line interface (CLI).
https://github.com/nuxt-hub/cli

Last synced: about 1 month ago
JSON representation

Build full-stack Nuxt application with NuxtHub command line interface (CLI).

Awesome Lists containing this project

README

        

# NuxtHub CLI

Command Line Interface for the [NuxtHub Admin](https://admin.hub.nuxt.com).

## Installation

Install the package globally:

```sh
npm install -g nuxthub
```

Or use `npx` to run the CLI without installing it:

```sh
npx nuxthub
```

## Usage

```bash
USAGE nuxthub init|deploy|link|unlink|open|manage|login|logout|logs|whoami

COMMANDS

init Initialize a fresh NuxtHUb project, alias of nuxi init -t hub.
deploy Deploy your project to NuxtHub.
link Link a local directory to a NuxtHub project.
unlink Unlink a local directory from a NuxtHub project.
open Open in browser the project's URL linked to the current directory.
manage Open in browser the NuxtHub URL for a linked project.
login Authenticate with NuxtHub.
logout Logout the current authenticated user.
logs Display the logs of a deployment.
whoami Shows the username of the currently logged in user.

Use nuxthub --help for more information about a command.
```

## Deploy

To deploy your project with NuxtHub, use the `nuxthub deploy` command. This will build your project and deploy it to your Cloudflare account with zero-configuration.

```bash
# Deploy to production or preview based on your current branch
nuxthub deploy

# Deploy to production
nuxthub deploy --production

# Deploy to preview
nuxthub deploy --preview
```

See [how to deploy with a GitHub action](https://hub.nuxt.com/docs/getting-started/deploy#github-action).

https://github.com/user-attachments/assets/9d7d9206-1ee3-4f8f-a29d-8b9dd09b9913

## Open in browser

To open your project in the browser, you can use the `nuxthub open` command. This will open the URL of your project in the default browser.

```bash
# Open the production or preview deployment based on your current branch
nuxthub open

# Open the production deployment
nuxthub open --production

# Open the latest preview deployment
nuxthub open --preview
```

## Open the project admin

To open your project's admin in the browser, you can use the `nuxthub manage` command. This will open the NuxtHub admin URL of your project in the default browser.

```bash
nuxthub manage
```

## License

[Apache 2.0](./LICENSE)