https://github.com/ragab0/wallet-mobile
https://github.com/ragab0/wallet-mobile
expo react react-hook-form react-native secure-storage tanstack-react-query typescript yup
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/ragab0/wallet-mobile
- Owner: ragab0
- Created: 2025-09-16T21:06:26.000Z (9 months ago)
- Default Branch: master
- Last Pushed: 2025-09-26T00:14:50.000Z (9 months ago)
- Last Synced: 2025-09-26T02:41:35.624Z (9 months ago)
- Topics: expo, react, react-hook-form, react-native, secure-storage, tanstack-react-query, typescript, yup
- Language: TypeScript
- Homepage:
- Size: 8.3 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
💳 Wallet Mobile App
A modern, cross-platform mobile application for personal finance management
Features •
Tech Stack •
Getting Started •
Project Structure •
API Integration
[](https://reactnative.dev/)
[](https://expo.dev/)
[](https://www.typescriptlang.org/)
[](https://react-query.tanstack.com/)
[](https://github.com/pmndrs/zustand)
[](https://react-hook-form.com/)
[](https://axios-http.com/)
[](https://docs.yup.io/)
## ✨ Features
### 🔐 Authentication
- Secure JWT-based authentication
- Email verification flow
- Social login (Google, Apple)
- Secure token storage
- Token refresh mechanism
### 💰 Transaction Management
- Add, view, and manage transactions
- Categorize income and expenses
- Transaction history with filters
### 👥 User Management
- User profile management
- Password reset functionality
- Role-based access control
### ⚙️ App Settings & Preferences
- Multiple theme support
- Notification settings
- Contact support via email/phone
- Report bugs directly from the app
- Rate the app
### 🎨 Modern UI/UX
- Clean, intuitive interface
- Multiple theme support with smooth transitions
- Responsive design for all devices
- Accessibility features
- Smooth animations and transitions
## 🛠️ Tech Stack
| Category | Technologies |
| --------------- | ------------------------------ |
| **Framework** | React Native, Expo |
| **Language** | TypeScript |
| **State** | React Query, Zustand |
| **Forms** | React Hook Form, Yup |
| **HTTP Client** | Axios |
| **Storage** | Expo SecureStore, AsyncStorage |
| **Icons** | Ionicons |
## 🚀 Getting Started
### Prerequisites
- Node.js 16+
- npm or yarn
- Android Emulator / iOS Simulator / Expo Go
### Installation
1. **Clone the repository**
```bash
git clone https://github.com/ragab0/wallet-mobile.git
cd wallet-mobile
```
2. **Install dependencies**
```bash
npm install
# or
yarn install
```
3. **Set up environment variables**
Create a `.env` file in the root directory with the following variables:
```env
EXPO_PUBLIC_API_URL=your_api_url_here
```
4. **Start the development server**
```bash
npx expo start
```
5. **Run on your device**
- Scan the QR code with your phone's camera (iOS) or Expo Go app (Android)
- Or use an emulator/simulator
## 🏗️ Project Structure
```
wallet-mobile/
├── app/ # Main app navigation and screens
│ ├── (auth)/ # Authentication flow
│ ├── (tabs)/ # Main app tabs
│ └── _layout.tsx # Root navigation layout
├── assets/ # Static assets
│ ├── fonts/ # Custom fonts
│ ├── images/ # App images
│ └── styles/ # Global styles
├── components/ # Reusable components
├── constants/ # App constants
├── hooks/ # Custom hooks
├── services/ # API services
├── configs/ # App configurations
│ ├── apiClient.ts # API client configuration
│ ├── queryClient.ts # Query client configuration
├── types/ # TypeScript types
├── utils/ # Utility functions
└── validations/ # Yup validation schemas
```
## 🌐 API Integration
The app integrates with a RESTful API built with NestJS. Key integration points include:
- **Authentication**: JWT-based auth with refresh tokens
- **Transactions**: CRUD operations with real-time updates
- **User Profile**: Manage user information and preferences
---
## 📸 Screens
---
Made with ❤️ by Ragab | 2025