DEV Community

Drod2386
Drod2386

Posted on

How I Built a Financial Literacy App with React, FastAPI, and PostgreSQL

Tags (pick these four): react, python, webdev, beginners

Body:

I built Compound, a financial literacy app that teaches things like compound interest, investing basics, and fees through short lessons, quizzes, and calculators. Here's how it's put together and what tripped me up along the way.

What it does

• A lesson path with quizzes that explain why each answer is right
• Calculators for compound interest, DCA, FIRE number, fee impact, mortgage breakdown, inflation hedge, and portfolio building
• Completion certificates
• Family accounts
Enter fullscreen mode Exit fullscreen mode

The stack

• Frontend: React + Vite + Tailwind, deployed on Vercel
• Backend: FastAPI + PostgreSQL, deployed on Railway
• Auth: JWT
• Content loading: a protected /admin/seed endpoint that loads the lessons
Enter fullscreen mode Exit fullscreen mode

Three things that tripped me up

  1. "vite: command not found" on Vercel.
    My deploy failed with vite build exited with 127. Exit code 127 means "command not found." My app lives in a frontend/ folder, but Vercel was building from the top of the repo, where there's no package.json, so it never even ran npm install. The fix was one setting: Project Settings → Build and Deployment → Root Directory → frontend.

  2. Keep secrets out of the repo.
    I use .env.example files with placeholder values and keep the real values in my host's environment variables. Before sharing the code, I exported a clean copy with git archive and searched it for .env files, keys, and connection strings. It's a quick check and worth doing every time.

  3. Rotate secrets at the source.
    After my hosting provider disclosed a security incident, I replaced my keys and passwords. The lesson: changing a value in your dashboard isn't enough. Revoke the old key with whoever issued it, or it may still work.

Try it

Live demo: https://compound-frontend-seven.vercel.app

If you'd like the source code to learn from or start your own project, it's available here (one-project license): https://dmlrod.gumroad.com/l/hdcon

What would you add? I'd love to hear what other developers would build into a learning app like this.

Top comments (0)