> For the complete documentation index, see [llms.txt](https://antsankov.gitbook.io/go-live/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://antsankov.gitbook.io/go-live/usecases/defaults.md).

# Local Development Server

The default use case of go-live is as local development server. This application will serve any files of the directory it's run in, including subdirectories.

## Serving an HTML Folder

```
cd my-html-project && go-live
```

{% hint style="info" %}
The index.html file will always be served at the the root as a default.
{% endhint %}

One you're serving the directory, a browser window should pop up, and you will see the server hosting all of the files in the directory, including subdirectories.

To use a different directory, you can the `--dir` flag, like below: 

```
go-live --dir ./my-html-project/
```

\
All relative URL paths in CSS or JS will work. You should see a server CLI dashboard. Any changes you make are not-cached and a refresh will show the new files.

![Running a Server](https://4192112914-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MIG-9ChqjpW2S2ZlhRl%2F-MIGD00Om4pQXyfa7Ahq%2F-MIGEUN0fdMxaHKpQLzm%2FScreen%20Shot%202020-09-27%20at%202.22.59%20PM.png?alt=media\&token=943f32ee-8073-41e2-90f0-6e954732cbab)

If the server allows outbound traffic, it is accessible from the internet or other devices on the subnet.