# Setup your first Space

### Overview

Spaces are containers for projects, tasks & bounties. They provide a glanceable view for all the work related to a single topic. Everything your team and community need to track and contribute to that topic can be housed in a space and divided into projects below it.

Additionally, you can set your workspace to either be a  `Space`  or  `Project`  by going to  `Settings`  >  `General`

* **Space**: Acts as a general-purpose container for your tasks & bounties, and is best suited for teams, depts, guilds, pods etc.
* **Project**: A great fit for work that is aimed at a specific goal and can have a timeline & budget

<figure><img src="https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FJzak4CQCy0bh4QuOnroN%2FSpace-Onboarding-00.jpg?alt=media&#x26;token=7d3233fd-bfa1-49f5-a29d-f7bf430d5f53" alt=""><figcaption></figcaption></figure>

### Board view

Using the efficient [Kanban board layout](https://en.wikipedia.org/wiki/Kanban_board), you can create and move tasks in any of 4 default columns: `To Do`, `In Progress`, `In Review`, and `Done.`

{% hint style="success" %}
You can use the menu at the top of any column to add sections within the column. Then you can shift a task between custom stages/steps of  `To Do`, `In Progress`  etc.
{% endhint %}

![A standard kanban view greets you in your main space ](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FN5irALIC56QmR2XJxIYs%2FSpace-Onboarding-01.jpg?alt=media\&token=53c9c1fe-8004-4db1-9c7f-372cb61497df)

### Filter & Sort

When you click on the settings icon next to the name of the view, you can filter by:

1. Tags
2. Assignees
3. Priority
4. Reviewer
5. Discord Roles
6. Skills
7. Templates

You can also sort by:

1. Custom (drag-n-drop)
2. Priority
3. Due Date
4. Creation Date
5. Bounty

Additionally, you can change the layout (Board, List, Grid), update which fields are visible for the view and choose to save the view customisations for everyone, as well.

{% hint style="info" %}
**Note**: Details and examples of using these options are covered later in [task-views](https://dework.gitbook.io/product-docs/fundamentals/task-views "mention")
{% endhint %}

![You can customise each view to be the most helpful, including the order of views](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FPQIs3PttN0oGtrqKEuDZ%2FSpace-Onboarding-02.jpg?alt=media\&token=73140649-84db-4fd9-bfcd-048a92ea7acd)

### Open Tasks view

This tab will list unassigned tasks in  `To Do`  status using a vertical list that is easy to scroll and best for quick filtering

![This is a handy preset view to aid in task discovery](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FOY1jq8tis5FGrSepNhHw%2FSpace-Onboarding-03.jpg?alt=media\&token=2b359fd2-5e45-4dc4-9ba0-2ebf9d0e07a1)

{% hint style="info" %}
Refer to [task-views](https://dework.gitbook.io/product-docs/fundamentals/task-views "mention")to learn more about community suggestions and also about adding a new view
{% endhint %}

### Overview

This provides a helpful view of key aspects of your space including:

* **About** - Maps who the key members are and features a description area for key information. The input area supports [markdown formatting](https://en.wikipedia.org/wiki/Markdown), has a rich-formatting menu accessed via the `/` command, and supports image drag-and-drop
* **Spaces** - Nested spaces and projects will be listed here as they are created
* **Open Tasks** - Tasks from the To Do status of the space, and nested spaces/projects, will get listed here for easy pick-up by contributors
* **Activity Feed** - Allows you to provide updates to your community or team, via Discord as well

![Provide your contributors with access to all core files, documents and more using the About section](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2F467DL299DuOH8tiarKf1%2FSpace-Onboarding-11.jpg?alt=media\&token=b7804fbd-72ee-4ab0-81d0-b32a891830cd)

{% hint style="success" %}
Share helpful information in the  `About`  section to ease onboarding, clarity of process, who are the PoCs and channels for communication
{% endhint %}

<figure><img src="https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2Fv3FuN613AZDbNzvQSgGB%2FSpace-Onboarding-12.jpg?alt=media&#x26;token=8fa13b25-5e82-4f56-8b2b-ae6bd13c9500" alt=""><figcaption><p>Add information to the About section of your space overview</p></figcaption></figure>

### Integrations

This is where you can connect Dework with other platforms to automatically sync information and keep your community up to date no matter where the work is getting done. By default it will take you to the Discord setup page, but you can easily navigate to the GitHub section via the Settings menu list.

As of now we support the following integrations for spaces:

* **Discord**: You can connect Dework to your organisation's Discord server which will add our Dework bot and help update the server about new tasks, applications, submissions and task completion. More information on [connecting-to-discord](https://dework.gitbook.io/product-docs/guides-for-orgs/connecting-to-discord "mention")&#x20;
* **GitHub**: You can connect Dework to your GitHub repo and automatically sync issues and updates, as well as see live status updates from GitHub directly in the task cards. More information on [github](https://dework.gitbook.io/product-docs/integrations/github "mention")
* **Notion**: You can connect a Space to Notion database(s) to enable the creation of bounties right from Notion tasks and track/pay them in Dework. More information on [notion](https://dework.gitbook.io/product-docs/integrations/notion "mention")

![Help your contributors get the most value out of Dework with handy integrations](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FwbnidRpSh48qeEgF39Yo%2FIntegrations-Discord-04.jpg?alt=media\&token=62c3b1eb-4a7c-4a9b-bd1e-d2e919705a73)

### Permissions

You can access the permissions of any space in your organisation via the  `Access & Permissions`  button at the top right corner of the space

{% hint style="info" %}
**Note**: More information on setting these up can be found on [permissions](https://dework.gitbook.io/product-docs/guides-for-orgs/setup-your-first-space/permissions "mention")
{% endhint %}

![Check the top right of your space to update permissions](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2F2PZLDvWAOw0Zh0fnk8On%2FPermissions-Roles-00.jpg?alt=media\&token=807f2369-3a02-4536-890d-e6c60010ab5d)

This will redirect you to the  `Permissions`  section of the space settings where you'll be able to set

![It's a shortcut to the permissions settings of your space](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2FrBWokSzKOuGfVQvmGnlN%2FPermissions-Roles-00.5.jpg?alt=media\&token=1655fb93-a898-4e41-a431-85d147819f91)

### Settings

Accessible via the settings icon next to the name of the Space, it allows you to update the following options:

1. **General** - Update the name, enable Community Suggestions and export all data via CSV
2. **Discord Integration** - Extend your Discord server with Dework to improve collaboration
3. **GitHub Integration** - Sync your tasks with GitHub issues to allow better management&#x20;
4. **Permissions** - Adjust permissions to match your needs across management and autonomy
5. **Templates** - Create templates to simplify creation of repeated task types&#x20;
6. **Payments** - Add payment methods to be used for task rewards
7. **Token Gating** - Gate your space and projects below via ERC20, 721 and 1155 tokens
8. **Manage** - here you can delete your space if it's no longer needed

{% hint style="info" %}
**Good to know:** The  `Main Space`  that gets automatically created is just one of many spaces you can have on Dework. Click on  `Overview`  at the top of the side menu to return to your organisation dashboard
{% endhint %}

![Customise settings for your space to match your needs](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2F4aQkRpcgqRHFYbgXvyTu%2FSpace-Onboarding-06.jpg?alt=media\&token=4e163bdd-636d-42ca-82fe-3180b12f3c18)

{% hint style="success" %}
As you add more tasks, and create more Spaces & Projects, your overview page will get filled out to make it easy to see your org ops in a single view
{% endhint %}

![What an active organisation dashboard could look like](https://1687189122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmz45Sf20wOeXiwishs9R%2Fuploads%2F4CHECVUUXxAGihhUTMD4%2FOrganisation-Home-01.jpg?alt=media\&token=1ce81c28-80e4-4f42-9bd2-fb7ea3c50220)
