Skip to main content
An organization is the central unit of your RefactKit application. Every user works within at least one organization, and everything — members, gallery images, settings, and any data you add — belongs to that organization exclusively. A single user account can belong to multiple organizations and switch between them freely.

​
Creating an organization

New users land on the onboarding flow at /onboarding the first time they sign in. This is where they create their first organization.
1

Enter an organization name

Type a name for your organization. The name must be unique across the platform and at least one character long. A URL-friendly slug is automatically derived from the name (e.g., Acme Corp → acme-corp).
2

Upload a logo (optional)

Add a logo image to help identify the organization. Logos are uploaded server-side and stored in Supabase Storage.
3

Submit

On success, you’re redirected to /organizations/acme-corp/dashboard. You are automatically assigned the Owner role.
Users who already belong to at least one organization as an Owner or Admin can create additional organizations. Plain Members cannot create new organizations.

​
Organization slugs

Every organization has a slug — a unique, URL-safe identifier generated from its name. The slug is used in every workspace URL:
Slugs are generated automatically when you create an organization, but Owners can update the slug later from organization settings. Changing the slug changes the URL of every page in that workspace.

​
Switching between organizations

If you belong to multiple organizations, you can switch between them using the organization switcher in the sidebar. Selecting a different organization navigates you to that organization’s dashboard at its slug URL. All data on screen is scoped to the currently active organization — no data from other workspaces bleeds through.

​
Inviting members

Admins and Owners can invite people to their organization by email. Invited users receive an email with an acceptance link.
1

Open the members page

Navigate to /organizations/:slug/members and click the invite button.
2

Enter the invitee's email and role

Specify the email address and choose the role (Member or Admin) the person will have when they join.
3

Invitation email is sent

The invitee receives an email with a link to /accept-invite?id=.... Invitations expire after 7 days.
4

Invitee accepts

When the invitee clicks the link, they are shown the accept-invite page. If they don’t have an account yet, they’ll be prompted to sign up first. Once they accept, they become a member of the organization with the role you specified.
Pending invitations are visible on the members page. Admins and Owners can revoke a pending invitation before it is accepted. Owners can also update the role on a pending invitation.

​
Managing membership

From the members page, Admins and Owners can:
  • View all current members and their roles
  • Update a member’s role (Admins can update non-Owner members; Owners can update anyone)
  • Remove members from the organization (Owner only)
An organization must always have at least one Owner. You cannot remove or demote the last Owner. Transfer ownership to another member first.

​
Organization settings

Owners can update the organization’s name, slug, and logo from /organizations/:slug/settings.
Enter a new name or slug and save. Changing the slug updates the URL of the entire workspace — any bookmarks to the old URL will break. RefactKit does not create redirects automatically when a slug changes.
Each organization has its own image gallery at /organizations/:slug/gallery. Gallery images are scoped to the organization — members of other organizations cannot see or access them. Uploading images to the gallery works through a server-side function (gallery-fns.ts) that writes to Supabase Storage and records the URL in the gallery_image table with the organization’s ID. Images are served from Supabase’s public CDN URL.

​
Deleting an organization

Only the Owner can delete an organization. The delete action is available in organization settings.
Deleting an organization is permanent and cannot be undone. All members, invitations, gallery images, and any other data belonging to the organization are deleted immediately via database cascade. There is no grace period or recovery option.
When an organization is deleted, members who were only in that organization will have no workspace on their next sign-in and will be redirected to the onboarding flow to create a new one.