Spaces

What are Spaces?

Spaces are workspaces for collaborating on application development and management with your team. They serve as organizational units that help members structure projects and work together efficiently within an organization.

Key Features

Project Organization: Group and manage related projects together
Team Collaboration: Space members automatically gain access to all projects within the space
Permission Management: Flexible access control based on organization roles
Activity Tracking: Monitor changes and updates within the space

Creating a Space

Space members automatically gain access to all projects within that space. Consider your team structure carefully when creating spaces.

Click the "+" Button

Click the "+" button in the Spaces section of the left sidebar.

Enter Space Information

Fill in the required details:

Space Name (required): Choose a descriptive name
Examples: "Marketing Team", "Development Division", "Project A"

Invite Members (Optional)

Select organization members to invite:

Members with Admin privileges automatically have access
Each member's organization role (Admin / Creator / Viewer) is displayed
You can always add members later

Create the Space

Review your information and click the "Create Space" button.

Member Invitation Guidelines

Space Members and Project Access

Automatic Access for Space Members: Members invited to a space automatically gain access to all projects within that space
Permission Levels: Each member's access level is determined by their organization role (Admin, Creator, Viewer)

Understanding Organization Roles

Admin: Has access to all spaces and projects, so they don't appear in the invitation list
Creator: Can create and edit projects
Viewer: Can only view projects

Inviting New Members to the Organization

From the space creation screen, click the "Invite members to organization →" button to send invitation emails for new members to join your organization.

Viewing and Selecting Spaces

The left sidebar shows all spaces you have access to.

Expanding and Collapsing Spaces

Click the arrow button next to each space name to expand it
When expanded, you'll see a list of projects within that space
Click again to collapse

Selecting a Space

Click on a space name to view its details in the main area

Managing Projects within Spaces

Space Detail Screen Layout

When you select a space, you'll see the following elements:

Header Area

Space Name: The name of the current space
Member Avatars: Icons of space members (multiple displayed)
- A "+number" next to avatars indicates additional members not fully displayed
Create Project: Create a new project
Activities: View activities within the space
Search Box: Search for projects within the space
Space Action Menu (...): Space management options

Project List

Projects are displayed as cards, each containing:

Project Preview Image: Screenshot of the application
Project Name: The name of the project
Last Update Time: Displayed as "Last updated XX ago"
Open App Button: Opens the deployed application
- May be disabled (grayed out) for some projects
Open Editor Button: Opens the code editor
Pin Button: Pin a project for quick access
- Pinned projects appear in the left sidebar
Duplicate Button: Create a copy of the project
- The following are carried over when duplicating:
  - Source code
  - System environment and environment variables
  - Data sources
  - Squadbase DB (schema information)

Creating a New Project

Click the "Create Project" button in the space detail header
Enter project information in the project creation screen
The project is automatically created in the current space

Member Invitation and Permission Management

How Space Members Work

In Squadbase, permission management for space members works as follows:

Automatic Access Grant

Members invited to a space automatically gain access to all projects within that space
No need to invite members individually for each project

Permission Levels

Important: Permissions are determined by organization roles. Make sure members have the appropriate role assigned before inviting them to spaces.

Role	Permissions
Admin	Full access to all spaces and projects. Can create, edit, and delete spaces and projects
Creator	Can create and edit projects within assigned spaces
Viewer	Can only view projects within assigned spaces

Adding Members Later

To add members who weren't invited during space creation, use the space settings screen or organization management screen.

Space Management

Click the "..." button on the right side of the space detail header to open the space action menu.

Available Actions

Invite Members to Space: Invite accounts that have signed up for Squadbase to the space
Rename Space: Change the space name
Delete Space: Delete the space

These actions are disabled for system spaces (e.g., "General").

About Space Deletion

Deleting a space has the following impacts:

You may lose access to all projects within the space
Deletion cannot be undone

Before deleting, consider backing up projects or migrating them to other spaces.

Create spaces by team: Organizing spaces by department or team—such as "Development Team", "Design Team", or "Marketing Team"—makes management easier
Organize by project purpose: Categorizing by purpose like "Production", "Testing", or "Experimental Projects" is also effective
Regular activity checks: Use the Activities button to stay informed about recent changes and updates within the space

Summary

Spaces are essential for streamlining team application development. By organizing your spaces properly and inviting the right members, you can achieve smooth collaboration.

If you have questions, check the "Help" or "Documentation" links for more detailed information.