Home Features Pricing Guides Blueprints FAQ Contact
App Store Google Play
.trackara-blueprint.json · format version 1

Blueprint templates

A blueprint is a job written down once, with the steps, the tools, the parts and the warnings, so you can run it again next time instead of remembering it. These are real, complete, editable files. Download one, import it, make it yours.

What a blueprint actually is

A single plain-text JSON file describing one job on a vehicle. It is not a log of work you did. It is the procedure you follow, which the app then turns into a checklist you tick off.

Steps you tick off

Each step carries its own description, estimated minutes, tools, parts, warnings, tips and a sub-checklist. You work down the list rather than holding the job in your head.

Editable in any text editor

No tooling required. Open it in Notepad, TextEdit or VS Code, change what you like, save, import. Minutes are minutes, categories are lowercase words, and only the title is mandatory.

Portable between apps

The same file imports on iOS and Android. The two apps store blueprints differently internally, so this format sits in the middle and both of them map to and from it.

Yours the moment it lands

Imported blueprints always arrive as your own local drafts. They never carry someone else's ratings, download counts or verified status. That information is deliberately not part of the file.

Importing one into the app

Four steps, and the last one is the important one.

1
Download the file

Tap any download link below. It saves as a .trackara-blueprint.json file, on iOS usually into Files, on Android into Downloads. If your browser tries to display it as text instead of saving it, use "Share" or "Save to Files" from the browser menu.

2
Open the file, or import it from the app

Easiest: tap the downloaded file and choose Trackara. It goes straight into your guide library. If you would rather do it from inside the app, open Settings → Blueprints and choose Import guides. Either way it accepts a single blueprint or a pack containing several, and a plain .json file works too, so a renamed file still imports.

3
Read what it tells you

The app reports what it did: how many blueprints came in and whether anything was skipped, such as a step with no title. It never silently drops content, and one bad entry never causes the whole file to fail.

4
Fill in your vehicle's numbers

Every template here is written generically on purpose. Torque figures, fluid capacities and part numbers vary by year, engine and trim, so the templates tell you to look yours up rather than handing you a number that might belong to a different car. Once you have looked them up, put them in your copy, and then you only ever do it once.

The templates

Nine files, eleven blueprints. All free, all editable, all validated against the format reference below.

Engine Oil & Filter Change
Drain, swap the filter, refill to capacity, log the mileage. Written so the three vehicle-specific numbers (capacity, viscosity and drain plug torque) get looked up in step 1 rather than guessed at.
Beginner maintenance 10 steps ~60 min 7 parts
engine-oil-and-filter-change.trackara-blueprint.json
Download
Front Brake Pads & Rotors
Full front brake service on sliding calipers: pads, rotors, hardware, slide-pin service and a proper bed-in. Includes the two steps people skip: cleaning the hub face, and pumping the pedal firm before moving the vehicle.
Intermediate brakes 13 steps ~200 min 8 parts
front-brake-pads-and-rotors.trackara-blueprint.json
Download
RV Water System Winterizing
End-of-season drain, water heater bypass, and either a regulated blow-out or pink antifreeze through every fixture. Covers the points that get forgotten: the city water inlet check valve, the P-traps, and the toilet bowl seal.
Beginner maintenance 13 steps ~170 min 4 parts
rv-water-system-winterizing.trackara-blueprint.json
Download
RV Onboard Generator Service (by Engine Hours)
Scheduled genset service driven by the hour meter, never by the coach's odometer or the calendar. Includes the exhaust and carbon monoxide inspection, which is the part of this job that actually matters.
Intermediate engine 12 steps ~175 min 8 parts
rv-generator-service-by-engine-hours.trackara-blueprint.json
Download
RV Roof Inspection & Reseal
The twice-a-year job that decides whether a coach stays dry. Starts by identifying the membrane type, because the sealant has to match it, and explains why silicone must never go anywhere near an RV roof.
Intermediate exterior 11 steps ~410 min 7 parts
rv-roof-inspection-and-reseal.trackara-blueprint.json
Download
No-Start Diagnosis: Crank, Spark, Fuel
A structured diagnostic walk that splits the problem in two at step 3 (does it crank or not), then follows one branch instead of throwing parts at both. Bring a multimeter and no parts at all.
Intermediate diagnostics 13 steps ~205 min 4 parts
no-start-diagnosis.trackara-blueprint.json
Download
Barn-Find Recommissioning
The full sequence for waking a vehicle that has sat for years, in the order that keeps you and the vehicle intact. Nothing gets turned, cranked, pressurised or driven until it has been proved safe. Twenty-three steps across many sessions.
Expert restoration 23 steps ~52 hours 12 parts
barn-find-recommissioning.trackara-blueprint.json
Download
Ten-Minute Jobs (pack of 3)
One file containing three separate blueprints: Engine Air Filter Replacement, Wiper Blade Replacement, and an Under-Hood Fluid Level Check. This is also the reference example of the multi-blueprint pack format.
Beginner pack · 3 blueprints 13 steps total 10-15 min each
ten-minute-jobs-pack.trackara-blueprint.json
Download
Minimal Example
The smallest file that works: a title and three step titles, nothing else. Eight lines of JSON. Use it as the skeleton for your own, and as proof that you do not have to fill in every field to get something useful into the app.
Beginner starter 3 steps 8 lines
minimal-example.trackara-blueprint.json
Download
A note on the technical content. These templates deliberately do not state torque figures, fluid capacities or part numbers for any specific vehicle. Those values differ by year, engine and trim, and a plausible-looking wrong torque spec is dangerous. Every template tells you which numbers to look up for your vehicle and where they matter most. Where a figure is given, it is either universal (a rule of thumb clearly labelled as one) or the template points you at the instruction printed on the part itself. Your service manual is always the authority.

Writing your own

The format is designed to be hand-written. Minutes rather than seconds, lowercase words rather than numbered codes, and exactly one required field.

Only title is required. Everything else has a sensible default. Unknown fields are ignored rather than treated as errors, so a file written for a newer version of the app still imports into an older one, and a field you invent for your own notes will not break anything.

The smallest file that works

minimal-example.trackara-blueprint.jsoncopy-pasteable
{
  "title": "Cold Tire Pressure Check",
  "steps": [
    { "title": "Read the recommended pressures off the driver's door jamb sticker" },
    { "title": "Check all four tires cold, before driving anywhere" },
    { "title": "Set each tire to the sticker value, then check the spare" }
  ]
}

Save that as anything.trackara-blueprint.json and import it. There is no formatVersion in it, which is fine, because absent means version 1. The category defaults to other, the difficulty to intermediate, and the steps get numbered in the order you wrote them.

A fuller one, with the fields you will actually use

structure of a complete blueprintcopy-pasteable
{
  "formatVersion": 1,
  "title": "Engine Air Filter Replacement",
  "description": "The easiest job on the car. Ten minutes, no tools on most vehicles.",
  "category": "maintenance",
  "subcategory": "Filters",
  "difficulty": "beginner",
  "tags": ["beginner-friendly", "10-minute job"],
  "language": "en",
  "estimatedMinutes": 10,
  "estimatedCost": 22.00,
  "currency": "USD",
  "author": { "name": "Your name", "bio": "", "url": "" },
  "vehicleCompatibility": [
    { "make": "Honda", "model": "Civic", "yearStart": 2016, "yearEnd": 2021, "engine": "1.5T", "notes": "" }
  ],
  "requiredTools": ["Screwdriver", "Shop rag"],
  "parts": [
    { "name": "Engine air filter element", "kind": "required", "quantity": 1,
      "partNumber": null, "estimatedCost": 22.00,
      "notes": "Look the number up for your engine and write it in here." },
    { "name": "Shop towels", "kind": "consumable", "quantity": 1 }
  ],
  "steps": [
    {
      "stepNumber": 1,
      "title": "Open the airbox",
      "description": "Release the spring clips or undo the screws and lift the lid.",
      "estimatedMinutes": 3,
      "tools": ["Screwdriver"],
      "parts": [],
      "warnings": ["Engine off, keys out."],
      "tips": ["Cabin air filters are a different job, usually behind the glovebox."],
      "checklist": ["Airbox located", "All clips released"],
      "imageUrls": [],
      "videoUrl": null
    }
  ],
  "coverImageUrl": null
}

Several blueprints in one file (a pack)

Wrap them in a blueprints array. Each entry is exactly the same shape as a single blueprint. The Ten-Minute Jobs download above is a working example.

pack formatcopy-pasteable
{
  "formatVersion": 1,
  "blueprints": [
    {
      "title": "Engine Air Filter Replacement",
      "difficulty": "beginner",
      "steps": [{ "title": "Open the airbox" }]
    },
    {
      "title": "Wiper Blade Replacement",
      "difficulty": "beginner",
      "steps": [{ "title": "Confirm the two blade sizes before you buy" }]
    },
    {
      "title": "Under-Hood Fluid Level Check",
      "difficulty": "beginner",
      "steps": [{ "title": "Park level, engine off and cool" }]
    }
  ]
}

Top-level fields

FieldTypeDefaultNotes
titlestringnoneThe only required field. A blueprint with no title is skipped.
formatVersionint1Absent means 1. Safe to leave out.
descriptionstringemptyWhat the job is and who it is for.
categorystringotherOne of the values listed below. Anything unrecognised falls back to other.
subcategorystringnullFree text, e.g. "Front axle".
difficultystringintermediatebeginner, intermediate, advanced or expert.
tagsstring[]emptyFree-form, for searching.
languagestringenBCP-47 language tag.
estimatedMinutesintsum of stepsMinutes, not seconds. Leave it out and it adds the steps up for you.
estimatedCostnumbernullParts total, roughly.
currencystringUSDThree-letter ISO 4217 code.
authorobjectnull{ name, bio, url }. Never carries any verified flag.
vehicleCompatibilityobject[]emptyEach entry: make, plus optional model, yearStart, yearEnd, engine, notes.
requiredToolsstring[]emptyThe whole-job tool list. Steps have their own too.
partsobject[]emptyOne flat list; kind splits it into required, optional and consumable.
stepsobject[]emptyA blueprint with no steps is still valid. It becomes a checklist stub.
coverImageUrlstringnullA URL or a relative path. Images are never embedded in the file.

Inside a step

FieldTypeDefaultNotes
titlestringnoneRequired. A step with no title is skipped and reported.
stepNumberintposition in the arrayOptional. The app renumbers on import, so you can reorder steps freely.
descriptionstringemptyThe actual instructions for the step.
estimatedMinutesintnullMinutes.
toolsstring[]emptyWhat you need in your hand for this step.
partsobject[]emptySame shape as the top-level parts list.
warningsstring[]emptySafety warnings. Shown prominently in the app.
tipsstring[]emptyThe things you only learn by doing the job once.
checkliststring[]emptySub-items to tick within the step.
imageUrlsstring[]emptyURLs or relative paths.
videoUrlstringnullA single video URL.

Inside a part

FieldTypeDefaultNotes
namestringnoneRequired. A part with no name is skipped.
kindstringrequiredrequired, optional or consumable. This is what splits the flat list into the three groups the app shows.
quantityint1
partNumberstringnullLeave it null unless you know it is right for the vehicle you are describing.
estimatedCostnumbernull
notesstringemptyFit notes, substitutions, what to check before buying.

Category values

Lowercase, exactly as written. Anything else falls back to other rather than failing.

enginebrakessuspension electricaltransmissionexhaust interiorexteriorwheels_tires fluidsdiagnosticsmaintenance performancerestorationother

Difficulty values

beginnerintermediateadvancedexpert

Things that are deliberately not in the file

Ratings, download counts, view counts, favourites, draft or published status, and any "verified creator" or "featured" flag are properties of a blueprint inside one person's install, not of the template itself. They are never written to a file, and if you add them by hand the app ignores them. An imported blueprint always becomes your own local draft with its counters at zero.

Common mistakes. Seconds instead of minutes in estimatedMinutes. Capitalised category or difficulty values such as "BRAKES" or "Beginner". Use lowercase; anything else silently falls back to the default. A trailing comma after the last item in an array or object, which is not legal JSON. Smart quotes pasted in from a word processor instead of straight " quotes. If a file will not import, paste it into any JSON validator first. It is almost always a punctuation error rather than anything to do with this format.

Run the blueprint in the app

Import it, tick off steps as you work, log parts and costs as you spend, and keep the whole job on file when you are done.

Related in Trackara