Skip to main content

Local Development

This section describes how to run Cashlytics locally for development.

Prerequisites​

  • Node.js 20+
  • npm
  • PostgreSQL instance

Setup​

git clone https://github.com/aaronjoeldev/cashlytics-ai.git
cd cashlytics
npm install
cp .env.example .env

Database​

npm run db:push

Start the App​

npm run dev

Then open http://localhost:3000.

Developer Expectations​

  • Keep TypeScript strict-mode compatible.
  • Use Server Actions for data mutations.
  • Keep schema and validation changes aligned.
  • Update documentation when feature behavior changes.