0 of 9 steps0%
Back to guides
TechMedium

How to Build the Perfect Spec

Learn how to create a well-structured, detailed spec on stephud — from setting up the tree hierarchy to adding details, sub-details, and nested options. Perfect for game loadouts, product configs, or any structured data.

admin
10 min
9 steps
5 views

Pick a Clear Name

Step 1 of 9

Start with a name that immediately tells people what your spec is about. Use all caps for the main title — it stands out in the tree view. Example: "BEST AK47 LOADOUT" or "MY WORKSPACE SETUP". The name should be specific enough that returning users can find it quickly.

Add Your First Details

Step 2 of 9

Click the red "ADD DETAIL" button to create a top-level detail item. This is your main category — like "PRIMARY WEAPON", "PERK 1", or "STEP 1". Give it a name and a value. The name shows in bold red, the value shows in blue next to it. For example: name = "PRIMARY WEAPON", value = "AK47".

Add Sub-Details for Attachments & Sub-Items

Step 4 of 9

Click the + button on any detail to add a sub-detail inline. This is where you list individual parts — like attachments on a gun, ingredients in a recipe, or sub-steps in a process. They appear indented with blue text and tree connectors (├─ └─ │). Keep sub-details short and punchy.

Build Options as Child Specs

Step 5 of 9

Use OPTIONS (child specs) when you want to offer choices — like multiple weapon loadouts under one class, or different recipes under one cuisine. Click "ADD OPTION" to add a new top-level item under the current spec. Those become separate items in the OPTIONS section and can have their own full detail trees.

Keep Details Flat and Options Nested

Step 6 of 9

Rule of thumb: if something IS a part of your spec, put it in DETAILS (sub-details). If something IS A VERSION of your spec, make it an OPTION. Example — "BEST AK47 CLASS": details have the perks and scorestrearks. Options below it have different weapon choices (AK47 loadout, KRM loadout, FFAR loadout).

Use Colors to Organize

Step 7 of 9

Top-level details use red by default. Sub-details use blue. This contrast makes it easy to scan. You can change any detail's color using the edit button (pencil icon). Red = header/category. Blue = specific item/value.

Add Files & Images

Step 8 of 9

Scroll down to the FILES section to attach images, PDFs, or documents. This is great for showing the actual item, a screenshot, or a diagram. Click "ADD FILE" to upload. Images show as thumbnails on the main spec card.

Use Right-Click for Quick Actions

Step 9 of 9

Right-click (or long-press on mobile) any item in the tree for a quick context menu. You can open, add an option inside, edit, or delete — without hunting for buttons. This is the fastest way to navigate and edit once you are used to it.

Preview and Publish

Step 10 of 9

Once your spec looks good, click into it from the main /specs page to see it as users will. Check that all details are readable, the hierarchy makes sense, and there are no typos. Share the link with friends or link it from a tutorial.