This tour walks you through every basic concept in Yellow in one short sitting: sign in, create a schema, define a model, save an instance, bookmark it, and see it on the dashboard. By the end you will have touched everything the rest of the docs talk about in depth.

Before you start

Sign in (see First login) and pick a tenant you can experiment in — a personal sandbox is ideal. The steps below assume you have permission to create schemas; if not, switch to a tenant where you do, or use a user-owned tenant.

1. Open the Explorer

Click the Explorer icon in the left rail. You'll see the schemas you can access on the sidebar.

2. Create a schema

Click + New schema at the top of the sidebar. Name it Notes, write a short description ("Personal notes"), pick User-owned as the owner if available, and Private access. Save.

The new schema appears in the sidebar.

3. Create a model

With Notes selected, click + New model. Name it Note. Add three properties:

  • title — String, required, mark as primary property.
  • body — String, multi-line.
  • createdOn — DateTime.

See Property types for the full catalogue.

Save. The Note model now appears under the Notes schema.

4. Create an instance

Open the Note model and click + New. Fill in:

  • title = "My first note"
  • body = "Yellow is a metadata-driven platform."

The createdOn field auto-fills with the current time. Save.

5. Bookmark it

Open the instance you just created and click the star icon in the header. The bookmark is saved to your profile for this tenant.

6. Pin it on the Dashboard

Go to the Dashboard. If there is not a Bookmarks widget already, add one from the + button at the top right. Your new note appears in the list — click to re-open it.

What you just learned

In ten minutes you walked through:

Everything else Yellow does is built on these pieces. The Concepts section explains each one in depth; the Tutorials section turns them into longer recipes.

Where to go next