dust-off-piano.netlify.app

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Omit to create. Pass an existing id to revise that lesson."
    },
    "title": {
      "type": "string",
      "description": "Short and concrete, e.g. \"G to A, slowly\"."
    },
    "summary": {
      "type": "string",
      "description": "One line the student will read on the lesson card."
    },
    "level": {
      "type": "string",
      "enum": [
        "first steps",
        "beginner",
        "improver",
        "challenge"
      ],
      "description": "How hard it is."
    },
    "tempo": {
      "type": "integer",
      "description": "Beats per minute for the demonstrations. 60-80 suits a beginner."
    },
    "steps": {
      "type": "array",
      "description": "The lesson, in order.",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "say",
              "show",
              "demo",
              "play"
            ],
            "description": "say | show | demo | play"
          },
          "text": {
            "type": "string",
            "description": "What the page tells the student at this step."
          },
          "notes": {
            "type": "array",
            "description": "Note names like \"C4\" or MIDI numbers. Nest an array for a chord. Required except for \"say\".",
            "items": {}
          },
          "fingers": {
            "type": "array",
            "description": "Finger per note, 1 = thumb to 5 = little.",
            "items": {
              "type": "integer"
            }
          },
          "label": {
            "type": "string",
            "description": "A name for what is highlighted, e.g. \"C major\"."
          },
          "beats": {
            "type": "number",
            "description": "demo only — beats per note. 1 is a steady walk."
          },
          "together": {
            "type": "boolean",
            "description": "demo only — sound the notes as one chord."
          },
          "focus": {
            "type": "string",
            "enum": [
              "accuracy",
              "timing",
              "evenness"
            ],
            "description": "play only — what to judge. \"accuracy\" is the right notes, \"timing\" is steady gaps, \"evenness\" is every note the same volume. Touch is the thing beginners cannot hear in themselves and the page can measure, so it is worth a step of its own."
          },
          "ignore_octave": {
            "type": "boolean",
            "description": "play only — accept the right notes in any octave."
          }
        },
        "required": [
          "kind"
        ]
      }
    }
  },
  "required": [
    "title",
    "steps"
  ]
}