Skip to content

kmccb/church-giving-manager

Repository files navigation

Church Giving Manager

A Windows desktop application for managing church member tithes, giving records, and financial reporting. Built for church administrators who need a simple, offline tool — no internet connection, server, or technical setup required.


Features

Dashboard

Get a real-time snapshot of your church's giving at a glance. The dashboard shows the current year's total giving, this week's contributions, your active member count, and a year-over-year comparison. Recent giving entries are listed in the center panel so you can quickly verify the latest records without navigating away.

Dashboard


Tithe & Giving Entry

Record individual giving entries in seconds. Choose a member from the dropdown, enter the amount and payment method (Cash, Check, or Other), and confirm the date. The check number field appears automatically when Check is selected. A weekly summary at the top shows the current week's total and entry count. A Batch Entry mode is available for recording multiple members at once — ideal for Sunday morning data entry. Recent entries are visible below the form for quick verification.

Tithe Entry


Member Management

Maintain a complete directory of your congregation. Each member record includes name, full address, email, phone, and active/inactive status. The member list shows the date of their most recent giving entry so you can spot lapsed givers at a glance. Use the search bar to quickly find anyone by name, email, or phone. Members can be deactivated (soft delete) rather than permanently removed, preserving their giving history for statements and reports.

Members


Financial Reports

Visualize your church's giving trends with interactive charts. Select any year to see:

  • Monthly Giving — bar chart of total contributions by month
  • Giving by Method — donut chart breaking down Cash, Check, and Other payments
  • Year-over-Year Comparison — side-by-side monthly bars comparing the selected year to the prior year
  • Active Givers by Year — line chart tracking how many members gave in each year

Summary cards across the top show the year total, number of entries, average entry amount, and the ratio of active givers to total members. Export the full year's data as a CSV with one click.

Reports


Annual Giving Statements

Generate IRS-style contribution statements for tax purposes. Select a year, then print or export statements for any member or all members at once. Each statement shows the member's complete giving history for the year, your church's name, EIN, and a customizable tax disclaimer. Statements are formatted for clean printing — one member per page. Options include Print Selected, Print All, and Save PDF.

Statements


Admin Panel

  • CSV Import — bulk import members and giving history from spreadsheets exported by other systems
  • Database Backup — download a copy of your .db file at any time for safekeeping
  • Database Restore — upload a backup to instantly restore all your data
  • User Management — create and edit staff logins, assign Admin or standard User roles
  • Church Settings — configure your church name, EIN, address, and pastor name (used on statements)
  • Audit Log — view a timestamped record of every data change and who made it

Admin


Themes

Six built-in color themes let you personalize the app's appearance. Choose from Stone, Glacier, Charcoal, Ember, Forest, or Midnight via the Theme button at the bottom of the sidebar. Your selection is saved automatically.

Themes


Security

  • Username/password login with bcrypt hashing
  • Role-based access: Admins manage users and settings; Users enter giving data
  • Rate limiting on login attempts
  • All data stored locally — nothing is transmitted over the internet

Installation

  1. Go to the Releases page
  2. Download Church Giving Manager Setup X.X.X.exe
  3. Run the installer (one-click, no admin rights required)
  4. Launch from the Start Menu or desktop shortcut

First Login

Field Value
Username admin
Password password123

Change the default password immediately via Admin → Users after first login.

First-Time Setup

  1. Go to Admin → Settings and enter your church name, EIN, address, and pastor name
  2. These values appear on all printed giving statements
  3. The app ships with sample data — delete it via Admin → Database before going live

Data Location

Your database is stored at:

C:\Users\<YourName>\AppData\Roaming\cotr-app\church.db

This file is preserved when you uninstall or update the app.


Tech Stack

Layer Technology
UI Framework Next.js 16 (App Router)
Desktop Shell Electron 40
Database SQLite via Prisma ORM
Authentication NextAuth.js v5
Styling Tailwind CSS + shadcn/ui
Charts Recharts
PDF Generation @react-pdf/renderer
CSV Parsing Papa Parse
Installer electron-builder (NSIS)

Development Setup

Prerequisites

  • Node.js 20+
  • npm

Getting Started

# 1. Clone the repo
git clone https://github.com/kmccb/church-giving-manager.git
cd church-giving-manager

# 2. Install dependencies
npm install

# 3. Set up environment
cp .env.example .env
# Edit .env — set AUTH_SECRET to any random string for local dev

# 4. Run database migrations and seed
npx prisma migrate dev
npx tsx prisma/seed.ts

# 5. Start the dev server
npm run dev -- -p 3003

Open http://localhost:3003 and log in with admin / password123.

Running in Electron (dev mode)

npm run electron:dev

Starts the Next.js dev server and Electron simultaneously. Hot reload works normally.

Building the Installer

npm run electron:build

Output: release/Church Giving Manager Setup X.X.X.exe


License

Private — for internal church use.

About

Windows desktop app for managing church member tithes, giving records, and tax statements. Fully offline — no internet required.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors