explaingit

nimraweb3/trading-journal

Analysis updated 2026-05-18

0TypeScriptAudience · vibe coderComplexity · 3/5LicenseSetup · moderate

TLDR

A self hosted personal trading journal for logging trades, tracking strategies, and reviewing performance with analytics and an AI weekly review.

Mindmap

mindmap
  root((Trading-Journal))
    What it does
      Logs trades and reasoning
      Tracks strategies
      Shows performance analytics
    Tech stack
      TanStack Start
      Supabase
      Tailwind CSS
    Use cases
      Personal trade log
      Multi account tracking
      AI weekly review
    Audience
      Retail traders
      Vibe coders
    Setup
      Clone and install
      Connect Supabase
      Run migrations

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Log individual trades with entry reasoning, screenshots, and risk to reward details.

USE CASE 2

Track performance separately across personal, prop firm, and funded accounts.

USE CASE 3

Review win streaks, drawdown, and profit factor on a visual dashboard.

USE CASE 4

Document trading strategies with entry rules and a pre trade checklist.

What is it built with?

TypeScriptReactTanStack StartTailwind CSSSupabaseRecharts

How does it compare?

nimraweb3/trading-journal0xradioac7iv/tempfs52191314/web-agent-proxy-sdk
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderatemoderate
Complexity3/53/54/5
Audiencevibe coderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires creating your own Supabase project and running database migrations before the app works.

In plain English

TradeBook is a personal trading journal that the author built for themself to log ICT and SMC style trades, tag mistakes, and spot patterns instead of guessing. It was built with the AI app builder Lovable and is shared here for other traders who want something similar or want to fork it and adapt it to their own style. A live demo is linked in the README. The journaling side lets you record rich trade entries covering pair, direction, trading session, killzone, strategy model, a letter grade, planned and achieved risk to reward, risk percentage, position size, and profit or loss. You can also write out the reasoning behind a trade before you know the outcome, attach multiple screenshots with previews and TradingView links, tag common mistakes like overtrading or revenge trading using presets or your own custom tags, and mark trades taken outside your plan. A strategy library section lets you document each trading model with its entry rules, confirmation signals, invalidation conditions, and a pre trade checklist, along with a performance breakdown per strategy. The app supports multiple accounts at once, such as personal, prop firm, demo, funded, or challenge accounts, each with its own starting balance and currency, and a global switcher filters every page by the active account. A dashboard shows an equity curve, drawdown curve, monthly returns, an activity heatmap similar to GitHub's contribution graph, win and loss streak tiles, and insights like your best and worst trading day or most traded pair. An analytics section adds an AI generated weekly review through Lovable's AI gateway, plus statistics like expectancy, average R multiple, profit factor, and rolling win rate, broken down by pair, session, day of week, model, and grade. Other touches include a command palette for quick navigation, keyboard shortcuts, built in risk and position size calculators, light, dark, and system themes, CSV export of trades, and installable offline support as a progressive web app. On the technical side it is built with TanStack Start and React, styled with Tailwind, and backed by Supabase for its database, authentication, and file storage, with security handled through row level security policies scoped to each signed in user and a private storage bucket for screenshots. Setup involves cloning the repository, installing dependencies, connecting your own Supabase project, running the included database migrations, and optionally configuring Google sign in.

Copy-paste prompts

Prompt 1
Help me connect my own Supabase project to this trading journal app, including running the migrations.
Prompt 2
Walk me through setting up Google sign in for this trading journal using Supabase auth.
Prompt 3
Explain how the risk analytics section calculates expectancy and profit factor in this codebase.
Prompt 4
Show me how to add a new account type to the multi account switcher in this project.
Prompt 5
Help me deploy this trading journal so I can access it from my phone as a PWA.

Frequently asked questions

What is trading-journal?

A self hosted personal trading journal for logging trades, tracking strategies, and reviewing performance with analytics and an AI weekly review.

What language is trading-journal written in?

Mainly TypeScript. The stack also includes TypeScript, React, TanStack Start.

How hard is trading-journal to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is trading-journal for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.