Skip to content

Commit 1a4af32

Browse files
committed
docs: add README for project overview
0 parents  commit 1a4af32

File tree

1 file changed

+84
-0
lines changed

1 file changed

+84
-0
lines changed

README.md

Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
# Cashflow Tracker
2+
3+
> **Note:** This README is for the public version of the `Cashflow Tracker` project. The actual project source code and additional details are in a private repository.
4+
5+
**`Cashflow Tracker`** is a web app designed to help users track their expenses and earnings, providing insights into their expenditure, spending, or profits across various categories such as food, travel, investments, and more.
6+
7+
## Project Overview
8+
9+
The Cashflow Tracker empowers users with the following features:
10+
11+
- **User Authentication:** Utilizes `Google` and `Facebook` `OAuth` for seamless user login, eliminating the need for additional signup.
12+
- **Expense Tracking:** Easily categorize and track expenses.
13+
- **Earnings Management:** Add and manage earnings for a comprehensive financial view.
14+
- **Entry Modification/Deletion:** Flexibility to modify or delete existing entries.
15+
- **Manual Operation:** Operates on a manual basis, ensuring user control without intrusive permissions.
16+
17+
## Tech Stack
18+
19+
- **Frontend:**
20+
21+
- [Angular](https://angular.io/)
22+
- [TailwindCSS](https://tailwindcss.com/)
23+
24+
- **Backend:**
25+
26+
- [Go](https://go.dev/)
27+
- [Gin](https://gin-gonic.com/)
28+
29+
- **Database:**
30+
31+
- [MongoDB](https://www.mongodb.com/)
32+
- [Firebase](https://firebase.google.com/docs/database)
33+
34+
- **Containerization:**
35+
36+
- [Docker](https://www.docker.com/)
37+
38+
## Development Server
39+
40+
To set up the development environment:
41+
42+
1. **Frontend (Client):**
43+
44+
- Navigate to the `client` directory and run `npm start` for a dev server.
45+
- Visit [http://localhost:4200/](http://localhost:4200/) to access the frontend.
46+
47+
2. **Backend (Server):**
48+
- Navigate to the `server` directory and run `go run main.go` or `go run .` for a dev server.
49+
- Visit [http://localhost:8080/ping](http://localhost:8080/ping) to ensure the backend is running.
50+
51+
### Prerequisites
52+
53+
Make sure you have the following installed on your local machine:
54+
55+
- [Node.js](https://nodejs.org/)
56+
- [Angular CLI](https://angular.dev/tools/cli)
57+
- [Go](https://go.dev/)
58+
- [MongoDB](https://www.mongodb.com/)
59+
60+
## Usage
61+
62+
End users can directly use the app at [https://cashflow-tracker.vercel.app](https://cashflow-tracker.vercel.app)
63+
64+
## Directories
65+
66+
This repo contains two directories `client` and `server` which are basically frontend and backend of the app respectively.
67+
68+
## Production
69+
70+
The Cashflow Tracker is deployed in a production environment, ensuring accessibility to users. The frontend is hosted on [Vercel](https://vercel.com), and the backend is hosted on [Railway](https://railway.app).
71+
72+
### Deployment Details
73+
74+
- **Frontend (Client):**
75+
76+
- Hosted on [Vercel](https://vercel.com)
77+
- Access the deployed frontend at [https://cashflow-tracker.vercel.app](https://cashflow-tracker.vercel.app)
78+
79+
- **Backend (Server):**
80+
81+
- Hosted on [Railway](https://railway.app)
82+
- Dockerfile included for containerization
83+
84+
Feel free to explore and experience the live application!

0 commit comments

Comments
 (0)