Quick Start

This walkthrough takes you from a blank project to an exported JSON Schema in about ten minutes. You'll build a simple schema for a product catalog — an object with a name, price, and a list of tags.

1. Create a new project

Launch SchemaStudio. If no project is open, the startup dialog appears. Click New Project. A blank workspace opens with a single untitled structure tab.

Go to File → Save and give your project a name — for example, ProductCatalog.ssproj. SchemaStudio saves projects as .ssproj package files that bundle the schema, data records, and changelog in one place.

2. Name your structure

The tab at the bottom of the design canvas shows the current structure name. Double-click the tab label and type Product.

Each tab is a separate schema structure. For this walkthrough you only need one.

3. Add a string field

In Design Mode, the toolbar above the canvas shows the available primitive types. Click String.

A new string field appears on the canvas. Click the field to select it. The Properties panel on the right updates to show all attributes for that field.

In the Properties panel, set:

  • Namename
  • TitleProduct Name (short description shown in forms and exports)
  • Required — checked

4. Add a number field

Click Number in the toolbar. A number field appears.

In the Properties panel, set:

  • Nameprice
  • TitlePrice
  • Minimum0
  • Required — checked

5. Add an array of strings

Click Array in the toolbar. In the Properties panel, set:

  • Nametags
  • TitleTags
  • Item TypeString

Leave Required unchecked — tags are optional on a product.

6. Validate the schema

Go to Tools → Validate Schema. If all required fields have IDs set and there are no structural conflicts, you'll see a confirmation that the schema is valid. Any issues are listed in the Issues panel at the bottom-left of the workspace.

7. Export to JSON Schema

Go to Export → Export as JSON Schema. Choose a save location and click Save. SchemaStudio generates a standards-compliant JSON Schema file for your structure.

The exported schema for this walkthrough looks like this:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Product",
  "type": "object",
  "required": ["name", "price"],
  "properties": {
    "name":  { "title": "Product Name", "type": "string" },
    "price": { "title": "Price", "type": "number", "minimum": 0 },
    "tags":  { "title": "Tags", "type": "array", "items": { "type": "string" } }
  }
}

8. Enter some data (optional)

Switch to Data Entry Mode using the toggle in the ribbon. The canvas changes to a form with one field per primitive you added. Fill in a product name, price, and any tags.

Use File → Save to save the record into the project. You can add more records with the + button in the navigation bar at the top.

When you're ready, go to Export → Export Data as JSON to export all records as a JSON array.

Tip: You can switch between Design Mode and Data Entry Mode at any time. Changes to the schema structure are reflected in the data entry form immediately.