A bilingual (English / Spanish) web app that helps people find errors in their credit reports and write dispute letters.
Status: Phase 0 — planning and project setup (started October 2026). The architecture, folder layout and roadmap are in place. Feature code is built in phases, listed below.
Errors on credit reports are common: wrong balances, accounts that are not yours, late payments that were paid on time, and old debts that should have aged off. Fixing them means reading a long report line by line and writing a formal dispute letter. That is hard for anyone, and harder still for people whose first language is not English.
- Read a credit report that the user uploads.
- Flag likely errors, for example:
- balances or dates that don't agree across the report
- duplicate accounts
- negative items older than the reporting period allows
- accounts or inquiries the user marks as "not mine"
- Explain each flag in plain English or Spanish.
- Draft a dispute letter for each issue, ready to print and mail to the credit bureau or the company that reported it.
CreditFix is an educational tool. It does not give legal advice.
Browser (React, English/Spanish)
│
▼
API server (Go) ───────► PostgreSQL
│
├──► Analyzer (Python): reads the report and extracts accounts
│
└──► Rule engine (C++): runs the error checks quickly
| Folder | Language | Planned role |
|---|---|---|
frontend/ |
React (JavaScript) | Upload page, results page and letter preview, in English and Spanish |
api/ |
Go | REST API that connects the frontend to the analyzer, the rule engine and the database |
analyzer/ |
Python | Turns an uploaded report into structured account data |
engine/ |
C++17 | Runs the error-checking rules on the structured data |
infra/ |
AWS | Deployment setup |
docs/ |
— | Roadmap and design notes |
samples/ |
— | Made-up sample reports for testing (never real personal data) |
| Phase | What gets built | Status |
|---|---|---|
| 0 — Setup | Repository, architecture, folder layout, roadmap | In progress |
| 1 — Core app | Upload a report → see flagged errors → download a dispute letter (English and Spanish) | Planned |
| 2 — Testing | Unit tests for each part and automated test runs on every push | Planned |
| 3 — Deployment | Live on AWS | Planned |
| 4 — Documentation | Public API documentation and a user guide | Planned |
See docs/ROADMAP.md for the detailed plan.
Credit reports contain sensitive personal information. CreditFix is designed so that:
- real reports are never committed to this repository (only made-up samples in
samples/) - uploaded files are processed and then deleted, not stored
- no data is shared with third parties
Zavier A. Paulino — github.com/zp1021 · linkedin.com/in/zavier-paulino
MIT — see LICENSE.