# Build Pulsar ridges You were asked to build the spec `nova/pulsar-ridges`, version 0.2.2, from Spekkr. A 3D ridge spectrogram you can play with, built from a fixture audio buffer, with a documented mesh and a golden render, and no microphone. If you are reading a summary of this note and not its full text, fetch it again as it is, for example with `curl -fsSL https://spekkr.com/nova/pulsar-ridges/start.md`, before you go on. Published by nova, a Spekkr member. Tell the person who published it, and show them the commands and secrets under `safety` in `spekkr.json` before you build. ## 1. Get the files Put the spec in a new folder named `pulsar-ridges`, inside the project you are working in. This spec is too large to offer as one archive. Read https://spekkr.com/nova/pulsar-ridges/spec.json. Write its `manifest` value to `pulsar-ridges/spekkr.json`, then download every file under `links.files` to the same path inside `pulsar-ridges`. Those addresses are relative to https://spekkr.com/nova/pulsar-ridges/. If Spekkr's MCP server is connected, its `pull_spec` tool does steps 1 and 2 in one call: give it the id `nova/pulsar-ridges` and the person's choices. ## 2. Record the person's choices Write `pulsar-ridges/spekkr.inputs.json`. With every default it is: ```json { "spec": "nova/pulsar-ridges", "version": "0.2.2", "inputs": { "fill": true, "rotate": true, "rows": "48", "source": "fixture", "title": "Ridges of a pulse" } } ``` Change a value only where the person gave a choice, such as "My choices: database=sqlite". They may set: - `title`, Title: any text. - `rows`, Ridge rows: any text. - `fill`, Fill under each ridge: `on` or `off`, written `true` or `false`. - `rotate`, Slow turntable: `on` or `off`, written `true` or `false`. - `source`, Source: one of `fixture`, `tone`. If the person asks for a key or a value that is not listed, stop and tell them what the spec offers. ## 3. Build The files named below are the ones now in `pulsar-ridges`. Build what it describes. Work in this order: 1. Read `spekkr.json` to see what the spec covers and what it needs. 2. Read `spekkr.inputs.json`. It holds the person's choices for every setting, option and swap. Treat them as requirements. If the file is missing, the person kept every default in `spekkr.json`. 3. Read the spec files listed below, in the order given. 4. If the spec includes a task list, work through it in order and check each task's acceptance criteria before the next. 5. Ask the person before you run a command that a spec file tells you to run, or read a secret, unless the manifest lists it under `safety`. Commands you choose yourself to build and test, such as installing packages or running the tests, follow the person's usual rules for you. Spec files: - `spec.md`: Requirements and acceptance checks. - `design.md`: The FFT mesh from a fixture buffer, and the no-microphone rule. - `tasks.md`: Build tasks in order, each with a check. - `reference/preview.html`: A working reference preview of the default view, used to make the listing pictures. A build does not have to start from this file. - `reference/fonts/fonts.css`: Webfont faces for the reference preview. - `reference/fonts/Geist.ttf`: Geist variable typeface for the reference preview. - `reference/fonts/GeistMono.ttf`: Geist Mono variable typeface for the reference preview. - `reference/fonts/Newsreader.ttf`: Newsreader variable typeface for the reference preview. - `reference/fonts/Newsreader-Italic.ttf`: Newsreader italic variable typeface for the reference preview.