Create a new site: start with a prepopulated site

The simplest way to create a new Docsy site is to use the source of the Docsy example site as starting point. This approach gives you a skeleton structure for your site, with top-level and documentation sections and templates that you can modify as necessary. The example site automatically pulls in the Docsy theme as a Hugo Module, so it’s easy to keep up to date.

If you prefer to create a site from scratch, follow Start a site from scratch.

TL;DR: Setup for the impatient expert

From a terminal:

git clone --depth 1 --branch v0.15.1-dev https://github.com/google/docsy-example.git my-new-site
cd my-new-site
npm install
hugo server

Preview at http://localhost:1313/. If the build fails with a missing Bootstrap import, see Troubleshooting.

Detailed Setup instructions

Clone the Docsy example site

The Example Site gives you a good starting point for building your docs site and is pre-configured to automatically pull in the Docsy theme as a Hugo Module. There are two different routes to get a local clone of the example site:

• If you want to create a local copy only, choose option 1.
• If you have a GitHub account and want to create a GitHub repo for your site go for option 2.

Option 1: Using the command line (local copy only)

If you want to use a remote repository other than GitHub (such as GitLab, BitBucket, AWS CodeCommit, Gitea) or if you don’t want a remote repo at all, simply make a local working copy of the example site directly using git clone. As last parameter, give your chosen local repo name (here: my-new-site):

git clone --depth 1 --branch v0.15.1-dev https://github.com/google/docsy-example.git my-new-site

Option 2: Using the GitHub UI (local copy + associated GitHub repo)

As the Docsy example site repo is a template repository, creating your own remote GitHub clone of this Docsy example site repo is quite easy:

1. Go to the repo of the Docsy example site.

2. Use the dropdown for switching branches/tags to change to the latest released tag v0.15.1-dev.

3. Click the button Use this template and select the option Create a new repository from the dropdown.

4. Choose a name for your new repository (e.g. my-new-site) and type it in the Repository name field. You can also add an optional Description.

5. Click Create repository from template to create your new repository. Congratulations, you just created your remote GitHub clone which now serves as starting point for your own site!

6. Make a local copy of your newly created GitHub repository by using git clone, giving your repo’s web URL as last parameter.

   git clone https://github.com/me-at-github/my-new-site.git
   

Preview your site

To build and preview your site locally, switch to the root of your cloned project, install the project dependencies, and use hugo’s server command:

cd my-new-site
npm install
hugo server

Preview at http://localhost:1313/. Thanks to Hugo’s live preview, you can immediately see the effect of changes that you are making to the source files of your local repo. Use Ctrl + c to stop the Hugo server whenever you like. If the build fails with a missing Bootstrap import, see Troubleshooting.

What’s next?

• Add some basic configuration
• Edit existing content and add more pages
• Customize your site
• Publish your site.