# How to achieve X – a step-by-step guide

**Level**: Beginner / Intermediate / Advanced
**Time**: ~NN minutes
**Prerequisites**: what readers must already have or know

## What we are building

Describe the end result. A screenshot or diagram helps:

```mermaid
flowchart LR
    A[Start] --> B[Configure]
    B --> C[Build]
    C --> D[Done]
```

## Step 1 – setup

```bash
install the thing
```

Explain what this command does and what success looks like.

## Step 2 – configure

```ts
const config = {
  key: 'value',
};
```

## Step 3 – the core work

The meat of the tutorial. Small steps, each verifiable:

1. Do this
2. Then this – expected output: `...`
3. Check it worked: `verify command`

## Troubleshooting

| Symptom | Cause | Fix |
|---------|-------|-----|
| Error X | Common mistake Y | Do Z |

## Next steps

- Where to go deeper
- Related tutorial