---
title: Welcome to docs.page!
description: Get started with docs.page
---

Welcome to docs.page! The init command you just ran created a basic file structure in your project to help you get started.

## Walkthrough

### Configuration

In the root of your directory, a new `docs.json` file has been created. This file configures your documentation site. You can customize the name, description, sidebar, theme, logos, and more.

Here's a basic example of what the file looks like:

```json title="docs.json"
{{{configurationExample}}}
```

To learn more about advanced configuration options, check out the [docs](https://use.docs.page/configuration).

### Content

docs.page uses the `docs` directory to store your documentation pages. Two pages have been created for you:

- `index.mdx` - The home page of your documentation site, resolves to the root URL.
- `next-steps.mdx` - A page to help you get started with docs.page, resolves to `/next-steps`.

Documentation can be written using the standard [GitHub Flavored Markdown Spec](https://github.github.com/gfm/) and also supports [MDX](https://mdxjs.com/) components for more advanced use cases.

## Preview

To preview your documentation site, head over to [https://docs.page/preview](https://docs.page/preview) in your browser and open this directory.

Previewing your documentation site lets you see changes in real time before you publish them.