Features
Templates and guided projects
Build a real project yourself with a guide beside your code — or start from the finished one.
Overview
Kiln has 16 templates: websites, apps, games, programs, a bot and an API. 15 of them can be built as a guided project. The switch at the top of the Templates gallery picks which you want:
| Mode | What you get |
|---|---|
| Learn by building | You start with the tricky or boring parts already done, and build the rest yourself, step by step. A guide panel checks your work as you go. |
| Starter project | The finished, working project, ready to change. Every one runs as-is. |
Starting a guided project
- Click Templates in the activity bar, then Browse all templates.
- Make sure Learn by building is selected at the top. Each card shows its level, number of steps and rough time.
- Click a template to see what you’ll build (web templates run live), what you’ll learn, what’s already done for you, and the steps.
- Click Start guided project, choose a name and location. Kiln creates the files, opens the one you’ll work in, and opens the Guide panel on the right.
How a step works
Each step says what you’re making, then walks you through it one small task at a time — like Kiln’s first-run tour, but in your code. A task shows:
- What to add — the code for this task, and which file it goes in.
- Where it goes — an arrow in the editor points at the line (“Add it below this line”, “Replace this line”). Show me where points again.
- Why — what the code does and why it’s needed, in plain words.
Type the code where the arrow points. Kiln notices when it’s there, ticks the task off and moves to the next one. Add it for me puts it in if you’d rather — typing it yourself helps you remember it. The dots at the top show your tasks; click one to go back.
Your turn
Some tasks are marked Your turn: you get what to do, but not the code. Give me a hint shows a hint, each a little more specific, and Show the answer shows the code if you’re stuck.
Checking the step
- Check my work (Ctrl+Enter in the panel) — tests what your code actually does and tells you, in plain words, what still needs fixing.
- Ask Sakura — she knows which step you’re on and sees your code. She explains and nudges rather than writing the answer. With no AI model connected, the offline helper gives hints and explains the failing check.
When every check passes, Next step unlocks. Comments in the code (“Provided”, “TODO (step 2)”) show which parts are yours.
What the checks do
| Project type | How it’s checked |
|---|---|
| Web projects | Load your page in a hidden preview and use it like a person would: type in boxes, click buttons, read what’s on screen. Some also call your functions with sample data — the weather app’s checks work offline. |
| Python and C++ programs | Run your program with set input (like typing 50, then 30) and read what it prints. Kiln fixes the “random” numbers during checks so it knows the right answer. |
| The API and the bot | Run a small test script that calls your functions. The API’s last step starts your real server and sends it HTTP requests. |
| Things outside Kiln | Like seeing your bot reply in Discord — you confirm those yourself. |
Progress and moving on
Progress — finished steps and tasks, and hints shown — is saved in the project, in .kiln/guide.json. Close Kiln, move the folder, or open it on another computer: the guide picks up where you left off. GUIDE.md in the project has the whole guide as plain text, so the project makes sense outside Kiln too.
If you close the panel, reopen it with Guide: Show the guide in the command palette (Ctrl+Shift+P). When the last step passes, the guide suggests ways to take the project further — it’s a normal project from then on.
Using a starter project
- Choose Starter project at the top of the gallery.
- Click a template to preview it, and use ← and → to move between templates.
- Click Use this template, choose a name and location, and Kiln creates the project and opens its main file.
What’s included
| Template | Guided version | To run it |
|---|---|---|
| My first web page | Beginner · 5 steps | Runs right away |
| Personal portfolio | Beginner · 5 steps | Runs right away |
| Landing page | Beginner · 4 steps | Runs right away |
| To-do list | Beginner · 6 steps | Runs right away |
| Calculator | Beginner · 4 steps | Runs right away |
| Weather app | Intermediate · 4 steps | Needs Internet connection |
| Quiz game | Beginner · 4 steps | Runs right away |
| Tic-tac-toe | Beginner · 5 steps | Runs right away |
| Snake | Intermediate · 4 steps | Runs right away |
| Number guessing (Python) | Beginner · 4 steps | Needs Python 3 |
| Rock, paper, scissors (Python) | Beginner · 5 steps | Needs Python 3 |
| Number guessing (C++) | Beginner · 4 steps | Needs a C++ compiler (g++ or clang++) |
| Notes API | Intermediate · 5 steps | Runs right away |
| Discord bot | Intermediate · 4 steps | Needs Node.js, npm install, and a Discord bot token |
| React: movie watchlist | Intermediate · 5 steps | Runs right away |
| React app | Starter only | Needs Node.js and npm install |
npm install first. The Discord bot’s guided steps are checked without a token; only the last step (connecting to Discord) needs one.