…
template-target: Home
template-levels: hero
-template-note: the start page of a new hero project, copied into it as its Home topic
+template-note: the start page of a new hero project, copied into it as its Home topic (the d2hero home, locked in by Razie 2026-09-25, v0.39.2)
---
# Home
-Your project's start page. It's a wiki topic, `Home`: change it any time, or ask your AI to.
+Your project's start page. It's a wiki topic, `Home`: change it any time, or ask your AI to. When your AI builds or imports an app for you, it adds a card for it right here, at the top.
-- **Your notes:** [the wiki](/topics). Write here, or let your AI keep notes, guides and decisions for you.
-- **Your data:** [Data](/dom). What you track appears here once your AI has described it: a portfolio, trails, a budget, a collection.
-- **Help:** [connect your AI](/help) so it can work here with you.
+## 1. Connect your AI
-## Getting started
+Your AI assistant does the building: it reads and writes this project's wiki, its data and its model through the API. It takes three things: network access, a token and the diesel2 skill.
-1. Connect your AI (see Help).
-2. Tell it what you want to keep track of, in your own words.
-3. Come back here: your notes and data will be waiting.
+1. **Let your AI reach d2.** Allow `*.aiheroapps.com` in your AI's network or web-access settings. In Claude, that's the list of allowed domains for code execution in your project or workspace.
+2. **Make a token for it.** Open [Tokens](/tokens), make one for your AI, and give it to your AI in the chat when it asks. Never paste it into a topic or a memory.
+3. **Install the diesel2 skill.** Open [[Skill:diesel2]], press **Markdown**, and save the text as `SKILL.md` in a folder named `diesel2`. Add that folder to your AI as a skill; in Claude, zip the folder and upload it as a custom skill.
+4. **Try it.** Ask your AI to *"list the topics in my d2 project"*. It should come back with Home and the rest.
+If something goes wrong, see [Help](/help).
+
+## 2. Examples
+
+Apps other people keep here. Open one to look around; ask your AI to *import* it and it's yours, with sample data to replace.
+
+```cards
+📈 | Portfolio | https://d2portfolio.aiheroapps.com | Holdings, what you paid, prices, and news on what you own
+🚵 | Bike trails | soon | Rides, trails, conditions and who you rode with
+🌱 | Garden | soon | Beds, what's planted, watering and harvests
+💰 | Budget | soon | Spending by category against what you planned
+🪙 | Collection | soon | Coins, cards or records: what you have and what you're after
+```
+
+## 3. Try it
+
+Say one of these to your AI, or something like it in your own words:
+
+- *"Build me an app to track my portfolio: my holdings, what I paid, today's price, and tell me when a company I hold puts out news."*
+- *"Import the portfolio example into my project and put in my three biggest holdings instead of the samples."*
+- *"I ride trails on my mountain bike. Keep track of the trails, when I rode them and the conditions, and show me which ones I haven't done in a while."*
+- *"Make me a garden planner: my beds, what's planted where, when I watered, and remind me what's due this week."*
+- *"Track my monthly budget: categories, what I planned and what I spent, and warn me when a category goes over."*
+