docs: layered information architecture (#140) (#163)

docs/getting-started.md

@@ -0,0 +1,60 @@
+# Getting Started
+
+## What You Need
+
+1. A Web3 wallet (MetaMask, Coinbase Wallet, etc.)
+2. Some ETH on **Base** network
+3. 5 minutes
+
+## Step 1: Get KRK Tokens
+
+1. Go to the [KrAIken app](/app/get-krk)
+2. Connect your wallet
+3. Swap ETH for KRK on Uniswap
+   - Make sure you're on **Base** network
+   - Use the 1% fee tier pool
+
+**Tip:** Start small. The protocol is unaudited — only use what you're comfortable risking.
+
+## Step 2: Stake Your Tokens
+
+1. Go to the [Staking Dashboard](/app/stake)
+2. Connect your wallet (if not already connected)
+3. Choose how many KRK tokens to stake
+   - Minimum stake is displayed in the form
+4. Pick your earning rate (tax rate)
+   - Lower = cheaper to hold, but easier to challenge
+   - Higher = more expensive, but harder to challenge
+   - Start with a mid-range rate if you're unsure
+5. Click **Stake** and confirm the transaction
+
+## Step 3: Monitor Your Position
+
+Once staked, you'll see your position in the **Active Positions** section:
+- Your slot count and ownership percentage
+- Current earning rate
+- Accrued tax obligation
+
+You can view detailed stats in your [Wallet Dashboard](/app/wallet/).
+
+## Understanding the Numbers
+
+- **Owner Slots**: Your share of the staking pool. 1,000 slots = 1% ownership.
+- **Tax Rate**: What you pay yearly to hold your position. Paid when you unstake or manually.
+- **Floor Tax**: The minimum rate needed to challenge existing positions.
+- **Positions Buyout**: How many positions your rate would displace.
+
+## Unstaking
+
+To exit a position:
+1. Find your position in the Active Positions list
+2. Click to expand it
+3. Choose to unstake (partially or fully)
+4. You receive your staked tokens plus any earnings, minus tax owed
+
+## Tips
+
+- **Check the floor tax** before staking. If it's high, many positions are actively defended.
+- **Watch the ETH reserve** on the landing page — growing reserve = healthy protocol.
+- **Don't panic if challenged** — you get paid out at market value. You can always re-stake.
+- **Join the community** — [Telegram](https://t.me/kraikenportal) for questions and discussion.