Skip to content

Finance-oriented app structured to be maintainable long term, applying software architecture and design concepts patterns. Created as a learning project for sustainable long term projects.

License

Notifications You must be signed in to change notification settings

Asterki/finance-app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

103 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Financial App

Manage your expenses and incomes effortlessly through a web interface. The Financial App provides a user-friendly platform to track finances with account management, security features, and access from anywhere, planning to add budgets and automatic transactions in the future.


Features

  • Track Income and Expenses.
  • Account System with secure authentication.
  • Access from any device with an internet connection.
  • Customizable Preferences for a tailored experience.
  • Two-Factor Authentication (TFA) for enhanced security.

Requirements

  • Node.js v20.17.0+ (Tested on this version)
  • PostgreSQL 17.1

Installation

  1. Clone the repository:

    git clone https://github.com/Asterki/financial-app.git
    cd financial-app
  2. Install dependencies:

    npm install
  3. Set up environment variables:

    • Copy .env.example files to .env in their respective locations (client and server).
    • Update the variables with your own values:

    Server .env:

    SESSION_SECRET="example"
    DATABASE_URL="postgresql://postgres:mysecretpassword@localhost:5432/postgres"
    
    EMAIL_HOST="EMAIL_HOST"
    EMAIL_PORT="EMAIL_PORT"
    EMAIL_SECURE="EMAIL_SECURE"
    EMAIL_USER="EMAIL_USER"
    EMAIL_PASS="EMAIL_PASS"
    EMAIL_FROM="EMAIL_FROM"

    Client .env:

    VITE_SERVER_HOST="http://localhost:3000"
  4. Start the application:

    npm start

Usage

  • Each file includes its own documentation for specific usage details.
  • Ensure .env variables are configured correctly to avoid runtime issues.

Contributing

We are not actively accepting contributions yet. However, you can:

  • Submit issues for bugs or feature requests.
  • Make pull requests for proposed changes.

Stay tuned for detailed contribution guidelines in the future.


License

This project is licensed under the Apache 2.0 License. If you use this project, you must attribute the original author.


Technologies Used

  • TypeScript
  • React
  • TailwindCSS
  • PostgreSQL
  • Prisma
  • Express

Contact

About

Finance-oriented app structured to be maintainable long term, applying software architecture and design concepts patterns. Created as a learning project for sustainable long term projects.

Topics

Resources

License

Stars

Watchers

Forks

Contributors 2

  •  
  •  

Languages