Strategy Builder
================

The Strategy Builder is a **visual, no-code editor** powered by Blockly.
You connect blocks together — like puzzle pieces — to define when to buy and sell.

----

The Canvas
----------

When you open the Workspace you'll see:

- **Left panel** — block categories (Indicators, Signals, Filters, etc.)
- **Centre canvas** — drag blocks here to build your strategy
- **Right panel** — backtest settings (market, dates, capital)
- **Toolbar** — Run, Save, Share, and Export buttons

----

Block Categories
----------------

.. list-table::
   :header-rows: 1
   :widths: 25 75

   * - Category
     - Description
   * - **Price Action**
     - Raw OHLCV data: Open, High, Low, Close, Volume.
   * - **Indicators**
     - Technical indicators: SMA, EMA, RSI, MACD, Bollinger Bands, etc.
   * - **Signals**
     - Buy / Sell trigger conditions (e.g. *RSI crosses below 30*).
   * - **Filters**
     - Optional entry conditions: time of day, minimum volume, trend filter.
   * - **Position Sizing**
     - Fixed lot size, percentage of equity, or Kelly Criterion.
   * - **Risk Management**
     - Stop-loss, take-profit, trailing stop, max drawdown exit.

----

Building a Simple Strategy
---------------------------

Example: **RSI Oversold Bounce**

1. Drag **RSI** block from *Indicators* → set period to ``14``.
2. Drag **Crosses Below** signal block → connect RSI output, set threshold to ``30``.
3. Connect the output to a **Buy Market Order** block.
4. Drag a second **Crosses Above** block → connect RSI, set threshold to ``70``.
5. Connect to a **Sell Market Order** block.

Your strategy now buys when RSI drops below 30 (oversold) and sells when RSI rises above 70 (overbought).

.. tip::
   Click any block and press **?** to open its built-in help tooltip.

----

Saving and Naming Your Strategy
--------------------------------

- Click **Save** (💾) in the toolbar.
- Give it a descriptive name, e.g. *RSI 14 — BTC Oversold*.
- Saved strategies appear in your **My Strategies** list.

----

Strategy Gallery
----------------

The Gallery lets you:

- **Browse** public strategies shared by other users.
- **Clone** any strategy to your own workspace with one click.
- **Star** strategies to save them for later.

.. note::
   Your own strategies are **private by default**. You choose when (and if) to share them publicly.