1---
1```frontmatter
2name: spaces
3description: create and manage spaces, configure access control, set up custom domains, and understand the identity model
4---
4```
5
6# spaces
7
8a space is the top-level container in sublimated. every space has a unique slug, an owner, and contains items (files and folders) organized as an ltree hierarchy.
36 unmodified lines
45
46roles (highest to lowest privilege): owner, admin, editor, commenter, viewer.
47
48rules support:
49
50- username: `alice`
51- email: `bob@example.com`
52- domain wildcard: `*@company.com`
53- public wildcard: `*` (anonymous access)
29 unmodified lines
83anonymous users can push to their own space immediately — no signup friction.
84
85## item hierarchy
86
86items are organized as ltree paths: `slug.folder.subfolder.file-md`
87items are organized as paths: `slug/folder/subfolder/file.md`
88
89- every folder is independently clonable as a git repo
90- items track: name, type, path, contentHash, sizeBytes, currentVersion
91- folders are implicit from paths but also stored as items (for metadata, permissions)
92
92## quotas
93
94spaces can have limits:
95- `maxStorageBytes` — storage cap
96- `maxRequestsPerDay` — API rate limit
97
98when usage exceeds 80%, a persistent warning appears on every response. at 95%+, severity escalates to error.
99
93## space configuration
94
95`.sbl/config.yml` in the space root configures:
96
97- build settings (which branches trigger Docker builds)
98- custom domain mappings
99- default visibility
100- feature flags
101
102pushed via git, parsed on push, takes effect immediately.
109
110## see also
111
112- git-workflow — clone and push to spaces
113- data-api — API endpoints for space management
114- connectors — sync external data into a space