Spaces
Learn about Squadbase Spaces for organizing your work
What are Spaces?
Spaces are workspaces for team collaboration in developing and managing applications. They serve as organizational units that help members structure projects and collaborate 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
In the left sidebar's "Spaces" section, click the "+" button next to the Space label.
Enter Space Information
Provide 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 also invite members later
Create the Space
Review your information and click the "Create Space" button.
Member Invitation Considerations
Space Members and Project Access
- Automatic Access Grant 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)
About Organization Roles
- Admin (Administrator): 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, you can click the "Invite members to organization →" button to send invitation emails for new members to join the entire organization.
Viewing and Selecting Spaces
Space Display in Sidebar
The left sidebar displays a list of all spaces you have access to.
Expanding/Collapsing Spaces
- Click the arrow button next to each space name to expand the space
- When expanded, a list of projects within that space is displayed
- Click again to collapse
Selecting a Space
- Click a space name to display that space's detail screen in the main area
Managing Projects within Spaces
Space Detail Screen Layout
When you select a space, the following elements are displayed:
Header Area
- Space Name: Name of the currently displayed space
- Member Avatars: Icons of space members (multiple displayed)
- If "+number" appears next to avatars, it indicates the number of members not fully displayed
- Create Project: Create a new project
- Activities: Display activities within the space
- Search Box: Search for projects within the space
- Space Action Menu (...): Space management operations
Project List
Projects are displayed as cards, with each card containing the following information:
- Project Preview Image: Screenshot of the application
- Project Name: Name of the project
- Last Update Time: Displayed in "Last updated XX ago" format
- Open App Button: Opens the deployed application
- May be disabled (grayed out) for some projects
- Open Editor Button: Opens the code editor
Creating a New Project
- Click the "Create Project" button in the header of the space detail screen
- Enter project information in the project creation screen
- The project is automatically created in the current space
Member Invitation and Permission Management
Space Member Mechanism
In Squadbase, permission management for space members works as follows:
Automatic Access Grant
- Members invited to a space are automatically granted 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. Ensure members have appropriate roles before inviting them to spaces.
Each member's permissions are determined by their Organization Role:
| 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 |
How to Add Members
To add members who weren't invited during space creation, do so from the space settings screen or organization management screen.
Space Settings
Click the "Settings" button in the bottom right of the screen to open the global settings screen.
API Keys Tab
Manage API Keys. You can create and manage API keys used for integration with external services and tools.
Notification Settings Tab
Manage notification settings. You can toggle the following notifications ON/OFF with switches:
Deployment Notifications
- Deployment Started: Notify when a new deployment starts
- Deployment Result: Notify when a deployment succeeds or fails
Collaboration Notifications
- Project Invitations: Notify when invited to a project
- Space Created: Notify when a new space is created
- Space Invitations: Notify when invited to a space
After changing settings, click the "Save Settings" button to save.
Space Management Operations
Space Action Menu
Click the "..." button on the right side of the header in the space detail screen to display the space action menu.
Available Operations
- Rename Space: Change the space name
- Delete Space: Delete the space
Note: For system spaces (e.g., "General"), these operations are disabled.
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.
Tips & FAQ
Q: What's the difference between spaces and projects?
A: A space is like a "folder" that groups multiple projects together. A project is a work unit that contains the actual application and code.
Q: Are space members different from project members?
A: In Squadbase, space members automatically have access to all projects within the space. Individual project member management is not necessary.
Q: I can't see spaces created by other members
A: Access to spaces is limited to invited members only. Organization Admins can view all spaces.
Q: How do I search for projects within a space?
A: Use the search box in the header of the space detail screen. You can search by project name.
Q: Are projects deleted when I delete a space?
A: A confirmation message will be displayed before the actual deletion operation regarding space deletion behavior. If you have important projects, we recommend backing them up in advance.
Best Practices
- Create spaces by team: Organizing spaces by department or project group such as "Development Team", "Design Team", "Marketing Team" makes management easier
- Organize spaces by project purpose: Classifying by purpose such as "Production Environment", "Test Environment", "Experimental Projects" is also effective
- Regular activity checks: Use the Activities button to check recent changes and updates within the space to stay informed about team status
Summary
Spaces are an important feature for streamlining application development in teams. By properly organizing spaces and inviting members, you can achieve smooth collaboration.
If you have any questions, please refer to the "Help" or "Documentation" links for more detailed information.