docs/index.mdx

Rama main · réplica de lectura del repositorio original.

---
title: FlintTrade Documentation
description: Beta public documentation for FlintTrade. The existing Next.js site remains the primary product, marketing, and install surface.
---

# FlintTrade Documentation (docs.page Pilot)

**Beta software. No financial advice. No promise of production readiness.**

This is a deliberately small, bounded docs.page MDX pilot. It demonstrates publication of representative pages without claiming a full Markdown to MDX migration of the canonical repository documents.

The canonical public FlintTrade documentation and the primary product surface remain on the existing Next.js site.

## Pilot Pages

- [Getting Started](./getting-started.mdx)
- [Product Modes](./product-modes.mdx)
- [Safety](./safety.mdx)
- [Contributing](./contributing.mdx)

All pilot content uses the canonical vocabulary: Modes **Practice** and **Live**; **Connected (read)** is a broker status, not a Mode; sample data labelled **Example**; the public web demo **Demo (example data)**; the app bar lists Terminal, Testing, Portfolio, Automation, Reports, Learn, Brokers, Settings, and System; older addresses **Home** and **Trade** open Terminal; provenance **Sample**, **Unavailable**, **Live**, **Stale**; current catalogue of **71** widgets.

External links point only to public FlintTrade GitHub material under https://github.com/navaneeshnagarajan/FlintTrade .

## Canonical Public Sources

- Repository: https://github.com/navaneeshnagarajan/FlintTrade
- README: https://github.com/navaneeshnagarajan/FlintTrade/blob/main/readme.md
- Quickstart: https://github.com/navaneeshnagarajan/FlintTrade/blob/main/docs/setup/QUICKSTART.md
- Developer guide: https://github.com/navaneeshnagarajan/FlintTrade/blob/main/docs/DEVELOPER_GUIDE.md
- CI guide: https://github.com/navaneeshnagarajan/FlintTrade/blob/main/docs/CI.md
- Order safety: https://github.com/navaneeshnagarajan/FlintTrade/blob/main/docs/ORDER_SAFETY.md
- Disclaimer: https://github.com/navaneeshnagarajan/FlintTrade/blob/main/disclaimer.md

## Provenance Independence Note

Mode (Practice and Live) is independent of data provenance (Sample/Unavailable/Live/Stale). The Mode chip is taken from the JWT session claim when the session token has one. An opaque sample session stays Example. An unconfirmed session shows Unavailable, never Example. Connected (read) is a broker status, not a Mode. Example is sample data, not a Mode. Practice does not imply Example data. Live mode does not guarantee a Live feed. Stale requires a real freshness clock; this page describes the label only.