How nox-mob/openledger works
Open Ledger is a self-hostable double-entry accounting app for small businesses and nonprofits. Users sign in, choose or create an organization, then manage its ledger: import bank statements as reviewable evidence, post transactions, reconcile accounts, and review reports. Organization settings cover accounts, members, terminology, and period close. Supabase provides authentication and organization-scoped data; the README describes row-level security and a database trigger enforcing balanced posted entries. Several feature routes and functions are represented by their exact tree paths because their implementations were not sampled.
Main entry points: org.functions.ts Organization functions · import.functions.ts Import operations · route.tsx Authenticated gate · reports.functions.ts Reports
Components 26
Access and shell
- Sign in
src/routes/auth.tsx - Authenticated gate
src/routes/_authenticated/route.tsx - App shell
src/components/AppShell.tsx - Legal acceptance
src/components/LegalGate.tsx
Organization setup
- Organization functions
src/lib/org.functions.ts - Organization onboarding
src/routes/_authenticated/onboarding.tsx - Organization settings
src/routes/_authenticated/settings - Account setup
src/routes/_authenticated/settings/accounts.tsx
Ledger operations
- Bank import review
src/routes/_authenticated/import.tsx - Statement parsers
src/lib/parsers - Import operations
src/lib/import.functions.ts - Transactions
src/lib/transactions.functions.ts - Accounts and funds
src/routes/_authenticated/accounts.tsx - Reconciliation
src/lib/reconcile.functions.ts - Period close
src/lib/close.functions.ts
Review and reporting
- Dashboard
src/routes/_authenticated/index.tsx - Reports
src/lib/reports.functions.ts - PDF reports
src/lib/report-pdf.ts
Data and policy
- Request authentication
src/integrations/supabase/auth-middleware.ts - Browser Supabase client
src/integrations/supabase/client.ts - Admin Supabase client
src/integrations/supabase/client.server.ts - Permission checks
src/lib/permissions.ts - Audit trail
src/lib/audit.ts - Supabase database
Other components
- User
- Supabase Auth
Connections 28
- User → Sign in: signs in
src/routes/auth.tsx - Sign in → Browser Supabase client: authenticates with
src/routes/auth.tsx - Authenticated gate → Browser Supabase client: checks user
src/routes/_authenticated/route.tsx - Authenticated gate → Legal acceptance: gates pages
src/routes/_authenticated/route.tsx - Authenticated gate → App shell: renders routes
- App shell → Organization functions: loads organizations
src/components/AppShell.tsx - Organization onboarding → Organization functions: configures organization
- Organization settings → Organization functions: manages settings
src/routes/_authenticated/settings/index.tsx - Account setup → Organization functions: loads organization data
- Bank import review → Import operations: submits import actions
src/routes/_authenticated/import.tsx - Bank import review → Statement parsers: parses and checks rows
src/routes/_authenticated/import.tsx - Import operations → Request authentication: requires auth
src/lib/import.functions.ts - Organization functions → Request authentication: requires auth
src/lib/org.functions.ts - Import operations → Permission checks: checks write access
src/lib/import.functions.ts - Organization functions → Permission checks: checks role access
src/lib/org.functions.ts - Import operations → Audit trail: records changes
src/lib/import.functions.ts - Organization functions → Audit trail: records changes
src/lib/org.functions.ts - Request authentication → Supabase database: validates claims
src/integrations/supabase/auth-middleware.ts - Browser Supabase client → Supabase Auth: manages sessions
src/integrations/supabase/client.ts - Import operations → Supabase database: reads and writes imports
src/lib/import.functions.ts - Transactions → Supabase database: reads and writes ledger
- Reconciliation → Supabase database: reads and updates matches
- Period close → Supabase database: closes periods
- Organization functions → Supabase database: reads and writes organization
- Dashboard → Reports: loads report data
src/routes/_authenticated/index.tsx - Reports → Supabase database: reads accounting data
- PDF reports → Reports: formats report output
- Admin Supabase client → Supabase database: admin access
src/integrations/supabase/client.server.ts