> For the complete documentation index, see [llms.txt](https://docs.hamina.com/hamina/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hamina.com/hamina/basics/creating-and-managing-projects.md).

# Creating and Managing Projects

Learn how to create projects, configure their settings, and organize them into folders with Hamina Network Planner.

{% hint style="info" %}
Each Hamina project is designed to model one building at a time. Use separate projects when working with multiple buildings for most accurate results and greatest performance.
{% endhint %}

Both the **Projects Menu** and **Projects Browser** can be used to create, switch between, and manage projects.

## Projects **Menu**

The Projects Menu gives quick access to:

* Settings in the current project, and other projects
* Recently opened projects, and all projects
* Projects Browser
* Creating new projects

## Projects Browser

<figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2FNhUfTd5f2v3CGEk9GXR3%2Fprojects-browser.png?alt=media&amp;token=6eaf37ac-e480-4e4c-9679-76914ff67180" alt=""><figcaption></figcaption></figure>

There are two ways to open the Projects Browser:

1. Either click the **Browse projects** button in the **Projects Menu:**<br>

   <div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2FGEy83rEp7CWoJR9bjOxz%2Fbrowse-projects-button.png?alt=media&amp;token=323d04bb-a5d7-4d17-a964-0f88857acf5c" alt="" width="375"><figcaption></figcaption></figure></div>

2. Or click the Hamina logo in the upper right:<br>

   <div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2FNiDPwaqno4lISjRPh8C3%2Fproject-browser-shortcut.png?alt=media&amp;token=61d6c321-f50c-4768-bf4e-c7aa601c5957" alt="" width="375"><figcaption></figcaption></figure></div>

### Project Status and Contents

The Projects Browser reveals the sharing status and contents of projects. The current project is outlined in blue:

<div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2FYdfrljywh7lhvplgmli8%2Fcurrent-project.png?alt=media&amp;token=d2918d4b-b746-4b24-b730-14bc0bc2b49c" alt="" width="276"><figcaption></figcaption></figure></div>

Mouse over the **Shared** indicator to see how many people the project is shared with:

<div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2F6DcCiJXNXuinSkNSG951%2Fhas-shared.png?alt=media&amp;token=704b63de-ad4a-4108-a38b-446b50def67a" alt="" width="563"><figcaption></figcaption></figure></div>

The icons on the right indicate what the project includes, such as simulation data, surveys, reports, and a Live View connection:

<div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2F3WTQux784JkudGPrNYn4%2Fhas-survey-measurements.png?alt=media&amp;token=112f2cae-e50c-42b6-8655-d6ffafd6daab" alt="" width="563"><figcaption></figcaption></figure></div>

## Creating Projects

To create a new project, click on the **Project drop-down menu**, and then the **+ New project** button at the bottom of the menu.

<div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2FsVAaXK7HPlGKwbtdDcDh%2Fproject-menu.png?alt=media&amp;token=4d9fea7a-1e75-42d3-9e94-44fbda40847a" alt="" width="375"><figcaption></figcaption></figure></div>

The **Create First Project** window will appear, which contains several settings.

<div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2FW7Cmk5U4H75APcTWUwzu%2Fcreate-new-project.png?alt=media&amp;token=475b7a93-bc6e-4ea3-9d1e-99c90ee91fb1" alt="" width="375"><figcaption></figcaption></figure></div>

#### Project name

Defines the name for the project. If you are working on a named building, this is a good place to put it.

#### Country

Defines the regulatory domain of the network, and will determine which Wi-Fi channels are available for use.

#### Environment

The **Environment** configures two aspects of the project:

1. How much attenuation to apply to the map if the prediction mode is set to **Env Type (PLE)**. This usually only happens when there aren't any walls or attenuating objects on the project. Learn more about switching prediction modes in [Heatmaps](/hamina/basics/heatmaps.md#simulation-models).
2. Sets the minimum ceiling height on maps in the project that haven't been added to the building with the **Align floors** tool. Learn more about this in [Managing Maps and Floors](/hamina/guides/maps-floors.md#ceiling-heights).

{% hint style="success" %}
While the environment type and "blanket attenuation" is good for rough AP count estimations, for true network designs, we recommend drawing walls and attenuating objects.
{% endhint %}

{% hint style="info" %}
If you need to model free space (such as a network in an open field), choose the **Free Space** environment type, which not apply any blanket attenuation to the project.
{% endhint %}

#### Project folder

Projects can be grouped together with folders. You can use folders to group together projects on a campus, by larger project, or by customer.

Folder and sub-folders can be created by adding forward slashes. For example:

`Area A / Campus A / Building 1`

`Area A / Campus A / Building 2`

`Area A / Campus B / Building 1`

<div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2FtCYUu3RHfoqh8W3ECcow%2Fsubfolders.png?alt=media&amp;token=df66475a-5d5c-47b6-bf59-3545c9f1fdfb" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="info" %}
If the project is shared with another user (either individually or as a team), they receive the same folder structure. You will also receive any edits made to the folder structure.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.hamina.com/hamina/basics/creating-and-managing-projects.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
