Walletly

Walletly is a multi-tenant workspace application for managing connections, payment categories, payment attempts, and ledger records.

Docker Image

You can pull the Docker image directly from Docker Hub:

docker pull bhwn7/walletly:latest

Docker Hub repository: https://hub.docker.com/repository/docker/bhwn7/walletly/general

Run the image locally (example):

# run detached and map port 3000 (adjust port and env as needed)
docker run -d -p 3000:3000 --name walletly bhwn7/walletly:latest

Features

• Workspace-like connections between senders and receivers, including categories and due amounts
• Payment lifecycle tracking with attempts, idempotency keys, and failure logging
• Ledger entries for debit and credit events plus audit trails per payment

Tech Stack

• Frontend: Next.js 16 App Router, React 19, Tailwind CSS
• Backend: API routes on Next.js, NextAuth (credentials)
• Data: PostgreSQL with Prisma ORM
• Tooling: TypeScript, ESLint, Prisma CLI

Prerequisites

• Node.js 18+
• PostgreSQL 14+ (or use Docker services below)
• npm (or any compatible package manager)

Quick Start (Local)

1. Install dependencies

npm install

2. Configure environment Create a .env file at the project root with at least:

DATABASE_URL=postgresql://postgres:postgres@localhost:5432/walletly
NEXTAUTH_SECRET=replace-with-random-string
NEXTAUTH_URL=http://localhost:3000
PORT=3000

3. Set up the database

npx prisma migrate dev --name init

4. Run the app

npm run dev

The app will be available at http://localhost:3000.

Database Migrations

• Local development: npx prisma migrate dev
• Production/CI: npx prisma migrate deploy