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:
- Create a free account at app.turso.tech (no card needed)
- Click Databases → Create Database, give it a name (e.g.
my-journal) - Open the database and copy its URL (starts with
libsql://) - Click Generate Token (read & write) and copy it
- 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.