The platform
Partly builtThe 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
HttpandSecretsabilities 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.