Skip to content
Platform · Overview2 pages

The platform

Partly built

The parts every Clay tool shares: who you are, where your work is kept, and what a program may use on your behalf.

Clay has several tools: the editor, Codebase, Phaistos, Cloud and Bindings. Underneath them are a few things they all rely on, so that you do not meet a different account, a different idea of “my workspace” or a different way of storing a password in each one. This section describes those shared parts. It is for people who want to know how Clay works and what it holds about them, not only how to use it.

What is built and what is only designed differs a lot from page to page, so each page says so at the top and again where it matters.

What this section covers

Part What it answers State
Accounts, devices and keys Who you are to Clay, how each of your devices proves it is you, and what happens when you lose one. Partly built
The domain model How accounts, workspaces, storage locations, tenants and organisations relate to each other. Partly built
Storage: bring your own bucket Where your code and your workspace live, and why Clay does not operate that place. Partly built
Secrets and connections How a program uses a password or an API key without ever seeing it. Partly built

Only the first row has a page yet. The others are designed and will be written up here:

  • The domain model. Accounts, workspaces, locations, tenants and organisations. A personal workspace, a sign-in and a storage location are built; tenants and organisations are a design.
  • Storage. Your work is kept in a storage account that you own, and Clay’s own services never become the only copy. Syncing to a bucket you configure works.
  • Secrets and connections. A vault, named connections and the Http and Secrets abilities exist for programs that run on a server you operate. Connecting to a cloud key service for the vault is not built yet.

The rule the rest follows

Whoever is the authority over something holds its key. Your work is signed with keys that you hold, in your own devices; Clay’s services carry public, signed statements from one place to another and never hold anything that could sign as you. The next page explains how that works, and where the design is ahead of the code.