0
Fork 0
mirror of https://github.com/withastro/astro.git synced 2024-12-23 21:53:55 -05:00
astro/docs/reference/cli-reference.md
2021-06-27 23:30:57 -07:00

59 lines
1.3 KiB
Markdown

---
layout: ~/layouts/Main.astro
title: CLI Reference
---
## Commands
### `astro dev`
Runs the Astro development server. This starts an HTTP server that responds to requests for pages stored in `src/pages` (or which folder is specified in your [configuration](../README.md##%EF%B8%8F-configuration)).
See the [dev server](./dev.md) docs for more information on how the dev server works.
**Flags**
#### `--port`
Specifies should port to run on. Defaults to `3000`.
### `astro build`
Builds your site for production.
## Global Flags
### `--config path`
Specify the path to the config file. Defaults to `astro.config.mjs`. Use this if you use a different name for your configuration file or have your config file in another folder.
```shell
astro --config config/astro.config.mjs dev
```
### `--project-root path`
Specify the path to the project root. If not specified the current working directory is assumed to be the root.
The root is used for finding the Astro configuration file.
```shell
astro --project-root examples/snowpack dev
```
### `--reload`
Clears the cache (dependencies are built within Astro apps).
### `--verbose`
Enables verbose logging, which is helpful when debugging an issue.
### `--version`
Print the Astro version number and exit.
### `--help`
Print the help message and exit.