2021-04-26 20:42:11 +00:00
|
|
|
# Development Server
|
|
|
|
|
|
|
|
The development server comes as part of the Astro CLI. Start the server with:
|
|
|
|
|
|
|
|
```shell
|
|
|
|
astro dev
|
|
|
|
```
|
|
|
|
|
|
|
|
In your project root. You can specify an alternative
|
|
|
|
|
|
|
|
## Special routes
|
|
|
|
|
|
|
|
The dev server will serve the following special routes:
|
|
|
|
|
|
|
|
### /400
|
|
|
|
|
2021-04-27 18:42:03 +00:00
|
|
|
This is a custom __400__ status code page. You can add this route by adding a page component to your `src/pages` folder:
|
2021-04-26 20:42:11 +00:00
|
|
|
|
|
|
|
```
|
2021-04-27 18:42:03 +00:00
|
|
|
├── src/
|
2021-04-26 20:42:11 +00:00
|
|
|
│ ├── components/
|
|
|
|
│ └── pages/
|
|
|
|
│ └── 400.astro
|
|
|
|
```
|
|
|
|
|
|
|
|
For any URL you visit that doesn't have a corresponding page, the `400.astro` file will be used.
|
|
|
|
|
|
|
|
### /500
|
|
|
|
|
2021-04-27 18:42:03 +00:00
|
|
|
This is a custom __500__ status code page. You can add this route by adding a page component to your `src/pages` folder:
|
2021-04-26 20:42:11 +00:00
|
|
|
|
|
|
|
```astro
|
2021-04-27 18:42:03 +00:00
|
|
|
├── src/
|
2021-04-26 20:42:11 +00:00
|
|
|
│ ├── components/
|
|
|
|
│ └── pages/
|
|
|
|
│ └── 500.astro
|
|
|
|
```
|
|
|
|
|
|
|
|
This page is used any time an error occurs in the dev server.
|
|
|
|
|
|
|
|
The 500 page will receive an `error` query parameter which you can access with:
|
|
|
|
|
|
|
|
```
|
|
|
|
---
|
2021-04-27 18:00:33 +00:00
|
|
|
const error = Astro.request.url.searchParams.get('error');
|
2021-04-26 20:42:11 +00:00
|
|
|
---
|
|
|
|
|
|
|
|
<strong>{error}</strong>
|
|
|
|
```
|
|
|
|
|
2021-04-27 18:42:03 +00:00
|
|
|
A default error page is included with Astro so you will get pretty error messages even without adding a custom 500 page.
|