Documentation

Everything you need to run TradeMarkk — pick a storage mode, import your trades, switch anytime.

On this page

1 · Hosted (easiest)

Sign up with email or Google. We provision a dedicated database for your journal — isolated from every other user. You can export everything or move to your own database at any time.

2 · Bring your own database

No terminal needed — everything works from Turso's web dashboard:

  1. Create a free account at app.turso.tech (no card needed)
  2. Click Databases → Create Database, give it a name (e.g. my-journal)
  3. Open the database and copy its URL (starts with libsql://)
  4. Click Generate Token (read & write) and copy it
  5. Paste both in the connect wizard

CLI fans: turso db create my-journal, then turso db show my-journal --url and turso db tokens create my-journal.

Credentials are stored only in your browser (optionally passphrase-encrypted). Every query goes directly from your browser to your database — we never see your data.

3 · Import your broker tradebook

Trades → Import CSV. For Zerodha: Console → Reports → Tradebook → select the date range → download CSV → upload. Columns are auto-detected; buys/sells are paired into round trips with charges applied. Re-importing the same file never creates duplicates.

4 · Switching storage modes

Settings → Switch storage mode. Your data is copied directly from your browser to the target (hosted ⇄ your DB ⇄ this browser), verified table-by-table, and only then switched. Leaving hosted starts a 30-day grace period before the hosted copy is deleted; your own database is never touched by us.

5 · Sharing trade snapshots

Share any trade from its detail page as a structured image card for reviews or notes. Your P&L is only included if you toggle it on, and image generation happens in the browser.

6 · Reading the blog

The blog collects practical notes on journaling, charges, reviews, backtesting, and data ownership.

7 · Self-host

Clone the repo, set the environment variables from .env.example (a Turso platform API token for hosted mode, Better Auth secret, optional Resend/Google keys, ADMIN_EMAILS for the admin panel) and deploy to Vercel. The README covers it step by step.