D

Core Concepts

The four nouns you'll see everywhere in Dokki: workspace, resource, member, role. Understand these and the rest of the product maps cleanly.

Workspace

A workspace is a tenant. Everything you create — docs, tables, artifacts, folders, tags, published sites — lives inside one. You can belong to multiple workspaces and switch from the sidebar.

  • Free plans are limited to 1 workspace.

  • Pro plans get unlimited workspaces.

Workspaces have their own member list, billing relationship, custom domain (Pro), and storage quota.

Resource

A resource is anything you can put in the sidebar tree:

  • Document — the rich-text editor.

  • Table — typed, real-time spreadsheet.

  • Artifact — interactive component or slide deck.

  • Folder — organizes other resources.

All resources share the same set of capabilities: you can rename, share, publish, tag, search, and delete them the same way.

Member

A member is a user who belongs to a workspace. Each member has a workspace role that controls what they can do globally inside that workspace:

  • Admin — manage members, settings, billing.

  • Editor — read and edit any resource.

  • Viewer — read-only.

Role (the three-tier system)

Permissions resolve from three sources, with this priority order:

  1. Document Role (per-resource, per-user): owner, editor, commenter, viewer.

  2. Workspace Role (per-workspace, per-user): admin, editor, viewer.

  3. Public Access (per-resource, anyone with the link): null, view, comment, edit.

The most permissive applicable tier wins, except when an explicit document role exists — that role caps the user's permission even if public access would grant more.

This means you can have a public document where one specific user is restricted to view-only, even though anonymous visitors get edit access.

Putting it together

Workspace
├── Members (with workspace roles)
└── Resources
    ├── Document
    │   ├── per-resource Document Roles
    │   └── Public Access setting
    ├── Table
    ├── Artifact
    └── Folder
        └── (more resources)

The next sections build directly on these concepts — when you read about Sharing, Publishing, or Permissions, you'll already know what each noun means.