> For the complete documentation index, see [llms.txt](https://comunity.gitbook.io/learning.comunitynexus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://comunity.gitbook.io/learning.comunitynexus/26.2/toolkit-guides/web-sites/create-a-web-site.md).

# Create a web site

A web site is a static site hosted by the platform and served from your project. Creating one provisions the site, its URL, and a starter project containing the platform helper library. Optionally, it also creates a DevOps repository so the site can be developed and version-controlled like any other codebase.

## Before you start

Creating a web site requires developer access to the project.

To create the web site inside a DevOps repository, a repository must already be configured for the environment. This is done once for the platform installation by a Toolkit administrator, as described in [Configure DevOps repositories](/learning.comunitynexus/26.2/toolkit-guides/web-sites/configure-devops-repositories.md). A project can also use a repository of its own, as described in [Set a project DevOps repository](/learning.comunitynexus/26.2/toolkit-guides/web-sites/set-a-project-devops-repository.md). Where no repository is configured, the option is unavailable and the web site is created without one.

## Create the web site

<figure><img src="/files/ol9zpiSo0oFTrzRjUkzV" alt=""><figcaption><p>Web sites</p></figcaption></figure>

1. Open your project and select **Web sites**.
2. Under **Web sites**, select **Add web site**.
3. Complete the dialog:

| Field                        | Description                                                                                                             |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Web site URL suffix**      | The path segment that identifies the site. It forms part of the published address.                                      |
| **Default document**         | The file the site serves as its entry point. Defaults to `index.html`. Required.                                        |
| **Create DevOps repository** | Creates the site in the configured DevOps repository. Unavailable when no repository is configured for the environment. |

The dialog displays the resulting **Web site URL** as you type the suffix.

4. Select **Add**.

{% hint style="info" %}
The **Default document** determines which file the site serves. It also determines how you package the site later: the file named here must sit at the root of any archive you upload. See [Manage web site files in the Toolkit](/learning.comunitynexus/26.2/toolkit-guides/web-sites/manage-web-site-files-in-the-toolkit.md).
{% endhint %}

## What a new web site contains

Every new web site is created with:

* the **default document**, a placeholder page confirming the site is live
* `.project.config`, holding the `server_url` and `project_name` values that identify the platform installation and project
* the **helper library** under `helper-lib-dist`, providing documented access to platform login, data, tracing and analytics

The helper library is included whether or not the site uses a DevOps repository. See [Extend a web site with the helper library](/learning.comunitynexus/26.2/toolkit-guides/web-sites/extend-a-web-site-with-the-helper-library.md).

## Web sites created in a DevOps repository

Where **Create DevOps repository** was selected, the web site entry provides:

| Control                         | Purpose                                                                    |
| ------------------------------- | -------------------------------------------------------------------------- |
| **Open repo**                   | Opens the repository in DevOps.                                            |
| **Clone repo**                  | Provides the clone URL for working on the site locally.                    |
| **DevOps URL** / **Remote URL** | The repository addresses. Displayed only for sites linked to a repository. |

The repository is created in the DevOps project configured for the environment. It is named from the project's **Application Name**, shown in Project Settings, and the web site URL suffix, joined by a hyphen.

## Community Central web sites

A Community Central site is created from the separate **ComUnity Central web site** section using **Add ComUnity Central**. Its name is determined by the project and cannot be set. See [Community Central](/learning.comunitynexus/26.2/toolkit-guides/web-sites/community-central.md).

## Deleting a web site

Deleting a web site in the Toolkit does not delete its DevOps repository. This is deliberate: the repository holds the development work, and removing the web site entry does not discard it.

To remove the repository, delete it in DevOps directly, with a user who holds rights to do so.

## Where to go next

* [Manage web site files in the Toolkit](/learning.comunitynexus/26.2/toolkit-guides/web-sites/manage-web-site-files-in-the-toolkit.md): add, upload and preview files without leaving the Toolkit
* [Extend a web site with the helper library](/learning.comunitynexus/26.2/toolkit-guides/web-sites/extend-a-web-site-with-the-helper-library.md): develop the site against platform data