https://github.com/afonsosousa123/expensetracker
Repo for a simple expenses tracker utility
https://github.com/afonsosousa123/expensetracker
expo react-native typescript
Last synced: 2 months ago
JSON representation
Repo for a simple expenses tracker utility
- Host: GitHub
- URL: https://github.com/afonsosousa123/expensetracker
- Owner: AfonsoSousa123
- Created: 2025-04-05T21:11:25.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-06T14:24:04.000Z (over 1 year ago)
- Last Synced: 2025-04-09T21:15:12.858Z (over 1 year ago)
- Topics: expo, react-native, typescript
- Language: TypeScript
- Homepage:
- Size: 252 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 💸 Expense Tracker (React Native + Expo)
A simple personal finance tracker built with **React Native**, **Expo**, and **TypeScript**.
## 🚀 Features
- Add transactions with title, amount, category and type (income or expense)
- List transactions
- Calculate and display total balance
- Store data locally using **AsyncStorage**
## 🧰 Tech Stack
- [Expo](https://expo.dev/)
- React Native
- TypeScript
- React Navigation
- AsyncStorage
- UUID
## 📦 Installation
1. Clone the repository
2. Install dependencies:
```bash
npm install
```
3. Start the development server:
```bash
npm start
```
4. Open the app in your preferred simulator or physical device using the Expo Go app.
5. You can also run the app on a web browser using:
```bash
npm run web
```
6. For Android, you can run the app using:
```bash
npm run android
```
7. For iOS, you can run the app using:
```bash
npm run ios
```
## 📁 Project Structure
.
├── App.tsx
├── screens/
│ ├── HomeScreen.tsx
│ └── AddTransactionScreen.tsx
├── components/
│ └── TransactionItem.tsx
├── types/
│ └── Transaction.ts
## 📌 Notes
- All data is stored locally with AsyncStorage.
- UUIDs are used to uniquely identify each transaction.
- The app is designed to be simple and user-friendly.
## 🛠️ To Do (Optional Improvements)
- Allow editing or deleting transactions
- Add filtering by date or category
- Integrate charts with react-native-svg for better visualization