- English name:
GistLedger - Chinese name:
云笺账本 - This project is a private cloud ledger built on GitHub Gist, focused on lightweight UX, serverless architecture, user-owned data, and responsive desktop/mobile layouts.
- The repository currently supports bilingual UI (
中文/English), light/dark theme, monthly budget tracking, responsive desktop layouts, and localized date/amount/export formatting. - Data is currently split into
ledger_data.jsonfor entries andledger_settings.jsonfor budget settings.
- After every real code or documentation change, create a
git commitimmediately instead of leaving multiple rounds of work uncommitted. - If a turn includes both product work and workflow/documentation updates, prefer separate commits so history stays readable.
- Any change that affects product capability, naming, workflow, or usage must update
README.md. - Any change that affects agent collaboration rules must update both
AGENTS.mdandGEMINI.md. - Temporary files such as
tmp*.jsonmust stay out of version control.
- Keep commit messages short and explicit, preferably using prefixes like
feat:,fix:,docs:,refactor:, orchore:. - Before committing, make sure
bun run lintandbun run buildpass locally.
- Package manager:
bun - Frontend:
React+TypeScript+Vite - Styling:
Tailwind CSS v4 - Icons:
lucide-react - Data access:
octokit - Deployment:
Cloudflare Workers