Your First Workspace

After verifying your email, the final onboarding step is creating your first workspace.

Every resource in SaaSStinger Lite belongs to a workspace. Projects, members, invitations, notifications, usage tracking, and audit logs are all scoped to a workspace, making the application secure and ready for multi-tenant SaaS products.

Creating your first workspace prepares your account for everyday use.

What You'll Learn

In this guide you'll learn:

• What a workspace is
• Why SaaSStinger Lite uses workspaces
• How to create your first workspace
• What happens behind the scenes
• How ownership works
• How to create additional workspaces later

Prerequisites

Before continuing, you should have completed:

• Installation
• Firebase Setup
• Environment Variables

You should also have:

• Registered an account
• Verified your email address

What Is a Workspace?

A workspace is the highest-level container within SaaSStinger Lite.

Instead of attaching data directly to a user, all business data belongs to a workspace.

For example:

Workspace
│
├── Members
├── Projects
├── Tasks
├── Notes
├── Tables
├── Notifications
├── Usage
└── Audit Logs

This architecture enables secure multi-tenancy, making it possible for a single user to belong to multiple organizations while keeping each workspace's data isolated.

Create Your First Workspace

After verifying your email, you'll be redirected to the onboarding flow.

The workspace creation form contains a single field.

Workspace Name
──────────────────────────────
My Company

[ Create Workspace ]

Enter a descriptive name for your organization, team, or business.

Examples:

• Acme Inc.
• Pixel Studio
• My Startup
• Internal Tools

Click Create Workspace.

What Happens Behind the Scenes?

Creating a workspace performs several operations automatically.

1. Workspace Created

A new document is created in the workspaces collection.

This becomes the primary container for your organization's data.

2. OWNER Membership Created

A membership record is created linking your account to the new workspace.

Your initial role is:

OWNER

The OWNER role has full administrative control over the workspace.

3. Usage Tracking Initialized

A usage document is created automatically.

This document stores usage counters and limits used throughout the application.

4. User Profile Created (If Needed)

If a user profile does not already exist, SaaSStinger Lite creates one automatically during onboarding.

Understanding Ownership

The creator of a workspace automatically becomes its OWNER.

Owners can:

• Manage workspace settings
• Invite members
• Assign roles
• Transfer ownership
• Delete the workspace
• Manage workspace resources

Because ownership is assigned automatically, no additional setup is required after creating your first workspace.

Multi-Workspace Support

Your first workspace is created during onboarding.

Later, you can create additional workspaces directly from the dashboard.

Each workspace is completely isolated.

For example:

John Doe

├── Personal Projects
├── Client A
├── Client B
└── Internal Team

Switching between workspaces changes the active context, ensuring you only access data belonging to the selected workspace.

Why SaaSStinger Lite Uses Workspaces

Many starter kits associate all data directly with a user account.

SaaSStinger Lite instead uses workspaces because they provide a stronger foundation for real-world SaaS applications.

Benefits include:

• Secure multi-tenancy
• Team collaboration
• Role-based access control (RBAC)
• Data isolation
• Organization management
• Future scalability

This architecture allows your application to grow from a solo project into a collaborative SaaS platform without requiring major structural changes.

Best Practices

Choose a workspace name that clearly represents your organization or project.

As your application grows:

• Invite teammates instead of sharing accounts.
• Organize work by workspace.
• Use separate workspaces for unrelated organizations or clients.
• Regularly review member roles and permissions.

Common Mistakes

Creating Multiple Workspaces Unnecessarily

Create additional workspaces only when data should be isolated.

Projects within the same organization generally belong in a single workspace.

Confusing Users with Workspaces

User accounts and workspaces serve different purposes.

A user represents a person.

A workspace represents an organization or team.

Using the OWNER Role for Everyone

Only trusted administrators should be assigned the OWNER role.

Grant the minimum permissions necessary for other members.

Related Articles

• Workspaces
• Members
• Invitations
• RBAC & Permissions
• Usage Tracking

Next Steps

Your workspace is now ready.

Continue with Running the Development Server to start exploring SaaSStinger Lite locally.