Workspace projects

An Arcweave project is a self-contained unit that holds the structure, content, and assets of an interactive story. It allows you to design, test, share, and export your work. Projects include project items such as boards, elements, and components, and support both collaboration and external integration.

The Projects section displays the workspace's projects.

ℹ️ Guests only see the projects they have been invited to.

Project thumbnails

All the workspace projects are shown as thumbnails in a grid. You can access project-specific options through the menu on each thumbnail.

Search

Use the search field to quickly filter projects by title.

Create projects

To create a new project:

1. Go to the Projects section of your workspace.
2. Click the + New Project button.
3. Select Blank Project among the available project templates.

A new project will be created and automatically opened.

ℹ️ Basic workspaces can have up to 3 projects.

✅ You can also import a project into your workspace.

Use the search field or the All templates, Examples, and Game Engines tabs to filter the available templates.

Project templates

Arcweave includes built-in project templates that you can recreate to expand and learn from. To create a project from one of the templates:

1. Go to the workspace's Projects section.
2. Click the + New Project button.
3. Select a template from the menu.

Current built-in templates include:

• Blank Project: an empty project for starting from scratch.
• Interactive Fiction Example: a simple example of Arcweave's basic flowchart and story features.
• Interactive Movie Example: an example of an interactive short film using video assets.
• Game Engine Example: the project used in the game engine integration tutorials.
• Tabletop Campaign Example: a simple campaign structure with dice rolling.
• Visual Novel Example: a tutorial-style visual novel with characters, backgrounds, and audio.
• Serious Games Example: simulated email-based security training with custom Play Mode CSS.

✅ Try the Game Engine Example to see how Arcweave integrates with popular game engines. Watch the video tutorials on the Unreal and Godot plugins to get a glimpse of such integrations.

Import projects

The Import projects permission allows users to import projects into a workspace.

• Arcweave JSON files can be imported into any workspace, as long as the import stays within the workspace's project and item limits.
• Native Arcweave backup files (.arcw) can also be imported into Pro and Team workspaces.
• In Team workspaces, projects can also be imported using Arcweave's REST API.

Arcweave JSON

You can also import a project from an Arcweave JSON file (.json) that was either previously exported from Arcweave or otherwise generated, as long as it follows the Arcweave JSON format.

⚠️ JSON import does not restore assets, element and component covers, element audio, or Asset List attribute values, and every item ID must be a UUIDv4. See Arcweave JSON for details.

✅ If the JSON includes board item coordinates (e.g. it were exported with Include coordinates enabled), board items will be restored to their original positions and sizes upon import.

Arcweave file

An Arcweave file (.arcw) is the native backup format used by Arcweave. It contains the complete project data, including notes, comments, and assets, as well as positions of all board items.

To generate an Arcweave file, export a project as a backup.

⚠️ Importing .arcw backup files is available in Pro and Team workspaces.

REST API

In Team workspaces, you can also import projects using the Import project endpoint of Arcweave's REST API.

Import a project

To import a project into your workspace:

1. Go to the Projects section of your workspace.
2. Click the Import button at the top right.
3. Choose the file format you want to import.
4. Select the file from your device and upload it.

Once the import is complete, the project will appear in your workspace's Projects list.

Invite people

Click the invite button (person icon with a plus) at the top right to invite team members to your workspace. This button requires the Manage memberships permission.

Project menu

From the Projects section, you can open the menu for any project to perform the following actions:

• Delete
• Duplicate (Pro and Team workspaces only)
• Rename
• Upload/Change cover
• Remove cover (if any)
• Move to workspace

The actions shown depend on your permissions. Duplicate requires Duplicate projects, Delete requires Delete projects, and Move to workspace requires Move project. Renaming and cover actions require Edit projects. As the project owner, you can also duplicate or delete projects you created.

Open project menu

Once in the Projects section, open the menu for a project as follows:

1. Hover over the project's thumbnail.
2. Click the ••• icon that appears at its top-right corner.
3. Select the action you want to perform from the menu.

Or:

1. Right-click the thumbnail.
2. Select the action you want to perform from the menu.

Delete projects

To delete a project:

1. Go to the workspace's Projects section.
2. Open the project's menu using the ••• icon or by right-clicking the thumbnail.
3. Select Delete.
4. Click Delete to confirm.

⚠️ Deleting a project is permanent and cannot be undone.

Duplicate projects

Pro and Team workspaces include the feature of project duplication. To duplicate a project:

1. Go to the workspace's Projects section.
2. Open the project's menu using the ••• icon or by right-clicking the thumbnail.
3. Select Duplicate.

Rename projects

To rename a project:

While the project is open: Click the project's name at the top left of the window.

From within the workspace:

1. Go to the workspace's Projects section.
2. Open the project's menu using the ••• icon or by right-clicking the thumbnail.
3. Select Rename.
4. Type a new name for the project and press Enter.

Project cover

You can add, change, or remove a project's cover image from the Projects section.

Add project covers

1. Go to the workspace's Projects section.
2. Open the project menu via ••• or right-click.
3. Select Upload cover and choose an image.

Project cover images can be .jpg, .jpeg, or .png files, up to 3 MB and at least 128 x 128 pixels.

Change project covers

1. Go to the workspace's Projects section.
2. Open the project menu.
3. Select Change cover and choose a new image.

Remove project covers

1. Go to the workspace's Projects section.
2. Open the project menu.
3. Select Remove cover.

Move projects

To move a project from one workspace to another:

1. Go to the workspace's Projects section.
2. Open the project menu.
3. Select Move to workspace.
4. Select the target workspace from the dropdown menu and press Move.

ℹ️ Moving projects requires Move project permission in the source workspace and Create projects permission in the target workspace. The target workspace must also have room for the project under its project and item limits.

Open projects

From the Projects section, click a project's thumbnail to open the project.

Exit projects

From within a project, click the Workspace icon at the top left of the window (next to the project name) to return to the workspace.