TradeFlow

AI-powered trading journal that makes journaling feel less like homework and more like a competitive edge.

What is this?

TradeFlow is a trading journal built for traders who want to identify behavioral patterns, track performance, and get AI-generated coaching — without spending hours on admin.

• Sub-30-second trade entry — just the fields that actually matter
• AI pattern detection — automatically surfaces your worst emotional habits
• Equity curve + analytics — win rate, avg R:R, P&L by asset
• AI Review tab — behavioral coaching based on your actual trade history

Screenshots

Log Trades	Dashboard	AI Review
Fast entry, one-tap emotions	See your patterns instantly	Get coaching in seconds

Tech Stack

• React 18 + TypeScript
• Vite (build tool)
• Tailwind CSS (styling)
• LocalStorage (no backend required)
• Zo AI integration (AI Review feature)

Running locally

git clone https://github.com/MB-Ndhlovu/tradeflow.git
cd tradeflow
npm install
npm run dev

Then open http://localhost:5173

Building for production

npm run build
npm run preview

Output goes to the dist/ folder.

Project structure

tradeflow/
├── index.html          # Entry HTML
├── package.json        # Dependencies + scripts
├── vite.config.ts      # Vite configuration
├── tsconfig.json       # TypeScript config
├── public/             # Static assets
└── src/
    ├── main.tsx        # React entry point
    └── App.tsx         # Full application

Roadmap

• Broker auto-sync (Alpaca, Interactive Brokers)
• Multi-user / group leaderboards
• Export discipline reports (for prop firm evaluations)
• Market replay integration
• Strategy tagging + performance by strategy
• PDF export for journal reviews

Contributing

Pull requests welcome. For major changes, open an issue first to discuss what you'd like to change.

License

MIT — free to use, modify, and distribute.