Finance Tracker

A personal finance dashboard built with React, Vite, AWS Amplify, Cognito, AppSync, and Chart.js.

Features

• Email sign up, login, and verification with AWS Cognito
• Dashboard cards and charts for income, expenses, and monthly spending
• Expense, income, and recurring payment management
• User profile and currency preference support
• GraphQL API generated through AWS Amplify

Tech Stack

• React 19
• Vite 7
• AWS Amplify 6
• AWS Cognito and AppSync
• Material UI
• Chart.js

Getting Started

Install dependencies:

npm install

Start the development server:

npm run dev

Build for production:

npm run build

Run lint checks:

npm run lint

AWS Amplify Setup

This repository intentionally does not include generated local AWS configuration files such as src/aws-exports.js, src/amplifyconfiguration.json, or Amplify local environment files.

To run the app against an Amplify backend, configure Amplify locally:

npm install -g @aws-amplify/cli
amplify pull

After pulling or creating an Amplify environment, the CLI will generate the local configuration file imported by src/main.jsx.

Public Repository Notes

Before pushing changes, check what Git will upload:

git status --short
git ls-files

Do not commit generated AWS config, local environment files, credentials, local databases, build output, or node_modules.

Project Scripts

• npm run dev starts Vite in development mode.
• npm run build creates a production build.
• npm run preview previews the production build locally.
• npm run lint runs ESLint.