p2 TS PROJECT MANAGER

stalha2110

May 1st, 2026

Never

Not a member of GistPad yet? Sign Up, it unlocks many cool features!

None 84.64 KB | None | 0 0

copy raw download clone embed print report

# 🚀 COMPLETE APP DEVELOPMENT PROMPT - CLIENT & PROJECT MANAGEMENT SYSTEM
## 📱 **APP OVERVIEW**
**App Name:** ClientFlow Pro / DevManage Hub
**Purpose:** A personal project and client management app for developers/freelancers to manage projects, clients, versions, tasks, payments, and revenue tracking.
**Target User:** Individual developers, freelancers, small agencies
**Platform:** Mobile App (iOS & Android)
**Languages:** English (India), Hinglish
**Default Currency:** Indian Rupee (₹), with support for USD ($)
---
## 🎨 **UI/UX DESIGN REQUIREMENTS**
The app design should be: **MODERN, PROFESSIONAL, UNIQUE, HIGHLY DESIGNED, WELL ORGANISED**
### **THEMES:**
Provide **5 THEMES** in Settings. Each theme must be:
- MODERN
- PROFESSIONAL
- UNIQUE
- HIGHLY DESIGNED
- WELL ORGANISED
- COMPLETELY DIFFERENT FROM EACH OTHER IN ALL ASPECTS (colors, style, feel, layout)
**Important:** One theme MUST have **multiple color-changing effects in the background with smooth transitions** to give an amazing, phenomenon experience.
---
## 🗄️ **BACKEND ARCHITECTURE**
### **Technology Stack:**
1. **Database (Structured Data - Small):** Firebase Firestore
2. **Storage (Large Files/Data):** Google Cloud Storage
3. **File Storage & Sync:** Google Drive
4. **Authentication:** Firebase Authentication
5. **Cloud Functions:** Supabase Functions
6. **Crash Reporting:** Firebase Crashlytics
7. **Remote Configuration:** Firebase Remote Config
8. **Analytics:** Firebase Analytics
### **Data Structure Guidelines:**
- Use Firebase Firestore for: user profiles, projects, clients, versions, tasks, revenue records, settings
- Use Google Cloud Storage for: large files, attachments, documents, images, backups
- Use Google Drive for: user data sync and cloud storage
- Implement real-time sync across all devices
- Auto-backup to cloud daily
---
# 📋 **PHASE 1: CORE FEATURES & MODULES**
## **MODULE 1: DASHBOARD (Home Screen)**
### **Dashboard Components:**
**Quick Stats Cards:**
- Total Revenue (this month with percentage change)
- Active Projects (count)
- Total Clients (count)
- Pending Tasks (count with badge)
**Revenue Graph:**
- Monthly revenue bar chart (last 6 months)
- Tap to expand for detailed view
- Color-coded by project
**Recent Activity Feed:**
- Last 10 activities with timestamps
- Types: Project created, Payment received, Task completed, Client added
- Filter option: All / Projects / Payments / Tasks
**Quick Action Button (Floating):**
- Add New Project
- Add New Client
- Add Revenue Entry
- Quick Add Task
### **Navigation:**
Bottom tab bar with:
- 🏠 Dashboard
- 📱 Projects
- 💰 Revenue
- 👥 Clients
- ⋯ More
---
## **MODULE 2: PROJECTS MANAGEMENT**
### **Add Project Flow:**
**Create Project Screen - Fields:**
- Project Name* (required)
- Project Type: Website / App / Both / Other (dropdown)
- Project Icon (image picker or icon library)
- Start Date* (date picker)
- Expected End Date (date picker)
- Project Status: Active / On Hold / Completed / Cancelled (dropdown)
- Base Price (number input with currency)
- Project Description (multi-line text)
- Attach Files (documents, designs, contracts)
**Save & Continue to Versions**
### **Project Detail Screen:**
**Header:**
- Project icon + name
- Status badge (color-coded)
- Edit / Delete / Share buttons
**Tabs:**
1. **Versions** - List of all versions for this project
2. **Files** - All attached files
3. **Notes** - Project notes
4. **Timeline** - Visual timeline of project
### **Versions Tab - Most Important:**
**Version List Display:**
Each version card shows:
- Version number/name (e.g., v1.0 - Basic)
- Client name (tappable)
- Revenue badge: ₹XX,XXX (color: Green=Paid, Orange=Partial, Red=Unpaid)
- Features count (e.g., "8 features")
- Task progress bar (e.g., "5/8 completed")
- Quick actions: View / Edit / Duplicate
**Add New Version Button**
---
## **MODULE 3: VERSION MANAGEMENT (CRITICAL FEATURE)**
### **Create Version Screen - Sections:**
**1. VERSION DETAILS:**
- Version Number/Name* (e.g., v1.0)
- Version Type: Free / Basic / Premium / Custom
**2. CLIENT INFORMATION:**
- Select Existing Client (dropdown with search)
- OR Add New Client:
- Client Name*
- Company Name
- Email
- Phone
- Address
- Client Avatar
**3. REVENUE DETAILS:**
- Total Project Cost* (number input)
- Amount Received (number input)
- Remaining Amount (auto-calculated, red if pending)
- Payment Status: Paid / Partial / Unpaid / Pending
- Payment Method: Bank Transfer / Cash / UPI / PayPal / Other
- Payment Date (date picker)
- Next Payment Date (for partial payments)
- Invoice Number (text input)
- Payment reminder toggle
**4. FEATURES INCLUDED:**
- Add Feature button
- Each feature has:
- Feature name*
- Description
- Status: Planned / In Progress / Completed / Dropped
- Priority: Low / Medium / High / Critical
- Delete option
**Feature Templates Library:**
Pre-defined features user can quickly add:
- User Authentication
- Admin Panel
- Payment Integration
- Push Notifications
- Responsive Design
- SEO Optimization
- Database Integration
- API Development
- (User can customize this library)
**5. TASKS & REMINDERS:**
- Add Task button
- Each task has:
- Task Title*
- Description
- Due Date & Time
- Priority: Low / Medium / High / Urgent
- Status: To Do / In Progress / Done
- Reminder: 15 min / 1 hour / 1 day / Custom before due
- Checklist items (sub-tasks with checkboxes)
- Attach files
**Task Views:**
- List View
- Board View (To Do | In Progress | Done)
- Calendar View
**6. TIMELINE:**
- Version Start Date*
- Expected Delivery Date*
- Actual Delivery Date
**7. DEPLOYMENT LINKS:**
- Development URL
- Staging URL
- Production/Live URL
- GitHub Repo Link
- Quick copy & open buttons for each
**8. ATTACHMENTS:**
- Upload documents, designs, contracts
- File preview support
- Stored in Google Cloud Storage
**Buttons:** Cancel / Save as Draft / Create Version
---
## **MODULE 4: REVENUE SECTION**
### **Revenue Dashboard:**
**Summary Cards:**
- Total Revenue (All Time)
- This Month Revenue (with % change)
- This Quarter Revenue
- Pending Payments (amount + client count)
- Average Project Value
**Filter Section:**
- Date Range: Custom / This Week / Month / Quarter / Year / All Time
- Project Filter (multi-select)
- Client Filter (multi-select)
- Payment Status Filter
- Export Button (Excel / CSV / PDF)
**Visual Analytics:**
1. **Revenue Trend Graph**
- Line/Bar chart
- Monthly/Quarterly/Yearly toggle
- Interactive (tap for exact values)
2. **Revenue by Project (Pie Chart)**
- Color-coded
- Percentage contribution
- Tap to drill down
3. **Revenue by Client (Bar Chart)**
- Top 10 clients ranked
- Total revenue per client
4. **Payment Status Distribution (Donut Chart)**
- Paid (Green)
- Partial (Orange)
- Unpaid (Red)
- Pending (Yellow)
5. **Monthly Comparison Table**
- Month | Revenue | Projects | Avg/Project | Growth %
**Revenue Transactions List:**
Sortable/Filterable table with:
- Date
- Client Name
- Project Name
- Version
- Amount
- Payment Method
- Status
- Invoice (download/view)
- Actions: Edit / Delete / Mark Paid
**Swipe Actions:**
- Swipe right: Mark as Paid
- Swipe left: Delete
**Insights Summary Cards:**
Auto-generated insights like:
- "Best month: March 2024 - ₹XX,XXX"
- "Revenue up 45% vs last quarter"
- "3 pending payments: ₹XX,XXX total"
- "Average project value: ₹XX,XXX"
- "Top client: [Name] - ₹XX,XXX"
---
## **MODULE 5: CLIENTS MANAGEMENT**
### **Clients List Screen:**
**Search & Sort:**
- Search by name/company/email
- Sort by: Revenue / Alphabetical / Recent / Projects Count
**Client Card Display:**
- Avatar/Logo
- Client Name
- Company Name
- Projects Count | Total Revenue
- Email
- Phone
- Quick Actions: View / Contact / Invoice
### **Client Detail Screen - Tabs:**
**1. Overview:**
- Contact information (editable)
- Total revenue
- Active/Completed projects count
- Payment history summary
- Quick contact: Call / Email / WhatsApp buttons
**2. Projects:**
- List all projects/versions for this client
- Add New Project button
**3. Invoices:**
- All invoices list
- Generate new invoice
- Send via email
**4. Notes:**
- Meeting notes
- Requirements
- Communication log
- Voice notes support
**5. Activity:**
- Timeline of all interactions
- Payments, projects, messages
---
## **MODULE 6: TASKS & REMINDERS**
### **Tasks Screen:**
**View Modes:**
- List View
- Kanban Board (To Do | In Progress | Done)
- Calendar View
- Priority View
**Filters:**
- All Tasks
- By Project
- By Client
- By Priority
- By Due Date
- Overdue Only
- Completed
**Task Card Elements:**
- Priority indicator (color-coded)
- Task title
- Project name
- Client name
- Due date & time
- Progress bar (if has sub-tasks)
- Sub-tasks checklist
- Buttons: Mark Done / Edit / Delete / Snooze
**Notification System:**
Push notifications for:
- Task due soon
- Payment due
- Project deadline approaching
- Payment received
- Custom reminders
---
# 📋 **PHASE 2: ADDITIONAL FEATURES**
## **FEATURE 1: Invoice Generator**
- Professional invoice templates
- Auto-populate from version/payment data
- Customizable fields
- Add discounts
- Show payment method info from settings
- Preview before generating
- Download as PDF
- Send via email directly
- Track status: Draft / Sent / Viewed / Paid
## **FEATURE 2: Expense Tracker**
Track project-related expenses:
- Hosting costs
- Domain purchases
- API costs
- Software subscriptions
- Freelancer payments
**Categories:**
- Infrastructure
- Development Tools
- Marketing
- Outsourcing
- Miscellaneous
**Show:**
- Total expenses
- Net Profit = Revenue - Expenses
- Expense breakdown charts
## **FEATURE 3: Time Tracker**
- Built-in timer for tasks
- Manual time entry
- Time logged per project/version
- Hourly rate calculator
- Generate timesheets
- Export time reports
## **FEATURE 4: Document Vault**
- Store contracts, NDAs, agreements
- Organize by client/project
- Quick search
- Tag system
- Secure with app lock
- Store in Google Drive
## **FEATURE 5: Templates Library**
User can save and reuse:
- Project templates
- Feature sets
- Pricing packages
- Email templates
- Proposal templates
- Contract templates
## **FEATURE 6: Goals & Targets**
Set and track:
- Monthly revenue goal
- Quarterly revenue goal
- Annual revenue goal
- Project count target
- Client acquisition target
Show:
- Progress bars
- Achievement percentage
- Notifications when goals achieved
## **FEATURE 7: Reports Generator**
Generate and export:
1. **Monthly Business Report:**
- Revenue summary
- Project summary
- Client summary
- Top performers
2. **Client Report:**
- Per-client analysis
- Project history
- Payment history
3. **Project Performance:**
- Time vs estimate
- Profitability
- Completion rate
Export as: PDF / Excel
Schedule: Auto-generate monthly
## **FEATURE 8: Search & Filter**
- Global search across all modules
- Search: projects, clients, tasks, payments
- Advanced filters
- Recent searches
- Search suggestions
## **FEATURE 9: Backup & Sync**
- Auto-backup to Google Drive (daily)
- Manual backup option
- Restore from backup
- Export all data (JSON / Excel)
- Sync across devices in real-time
---
# 📋 **PHASE 3: SETTINGS MODULE**
## **SETTINGS STRUCTURE**
Create organized settings with these sections:
### **1. BUSINESS PROFILE**
Fields to save:
- Business logo (upload/change/remove)
- Business name*
- Tagline
- Email*
- Phone number
- WhatsApp number (checkbox: same as phone)
- Website URL
- Address: Street, City, State, PIN, Country (dropdown for country)
- Digital signature (upload / draw / clear)
Simple form layout with save button.
---
### **2. REGION & FORMAT**
**Language:**
- English (India) - Default
- Hinglish
**Currency:**
- Indian Rupee (₹) - Default
- US Dollar ($)
- Euro (€)
- British Pound (£)
**Currency Display:**
- Symbol format: ₹1,234.56
- Code format: INR 1,234.56
**Thousand Separator:**
- Comma (1,234,567)
- None (1234567)
**Indian Numbering System:**
- Toggle ON/OFF
- When ON: 12,34,567
- When OFF: 1,234,567
**Date Format:**
- DD/MM/YYYY (default for India)
- MM/DD/YYYY
- YYYY-MM-DD
**Time Format:**
- 12-hour (AM/PM) - default
- 24-hour
**Week Starts On:**
- Sunday (default)
- Monday
**Preview Section:**
Show preview of selected formats:
- Currency: ₹12,34,567
- Date: 28/12/2024
- Time: 05:30 PM
---
### **3. PROJECT DEFAULTS**
Default settings for new projects:
**Project Settings:**
- Default project type: Website / Mobile App / Both
- Default status: Active / Planning / On Hold
- Default duration: 7 / 15 / 30 / 60 / 90 days
**Version Settings:**
- Version naming: v1.0, v2.0 / v1, v2 / Basic, Premium
- Auto-increment version: ON/OFF
**Sorting Preferences:**
- Default project sort: Recently Updated / Name / Date
- Default client sort: Revenue / Name / Recent
- Default task sort: Due Date / Priority / Recent
Simple dropdowns and toggles.
---
### **4. PAYMENT METHODS**
Store payment information (displayed on invoices):
**Bank Transfer:**
- Enable/Disable toggle
- Bank name
- Account holder name
- Account number (with show/hide)
- IFSC/Routing code
- Account type: Savings / Current
**UPI:**
- Enable/Disable toggle
- UPI ID
- Generate QR code button
**Cash:**
- Enable/Disable toggle
**PayPal:**
- Enable/Disable toggle
- PayPal email
**Invoice Settings:**
- Invoice prefix (text: e.g., "INV")
- Starting number (e.g., "001")
- Preview display: INV-001
- Payment terms: Due immediately / 7 days / 15 days / 30 days / 60 days
---
### **5. NOTIFICATIONS**
**Master Control:**
- Enable all notifications: ON/OFF
**Notify me for:**
- Task reminders ☐
- Payment due ☐
- Project deadlines ☐
- Payment received ☐
- Daily summary ☐
- Weekly report ☐
**Notification Style:**
- Sound: ON/OFF
- Vibration: ON/OFF
- Show on lock screen: ON/OFF
**Quiet Hours:**
- Enable: ON/OFF
- From: (time picker) 11:00 PM
- To: (time picker) 08:00 AM
**Reminder Defaults:**
- Remind before: 15 min / 1 hour / 1 day / At due time
**Calendar Sync:**
- Sync with device calendar: ON/OFF
- What to sync:
- Task deadlines ☐
- Project deadlines ☐
- Payment due dates ☐
- "Sync Now" button
---
### **6. BACKUP & DATA**
**Cloud Backup:**
- Auto backup: ON/OFF
- Backup frequency: Daily / Weekly / Manual only
- Backup only on WiFi: ON/OFF
- Last backup: (show date & time)
- Backup size: (show in MB)
- "Backup Now" button
**Restore:**
- List of available backups (show date)
- Each has: "Restore" button / "Delete" button
**Export Data:**
- Export format: Excel / CSV / PDF
- "Export All Data" button
- Saves to device downloads folder
**Storage:**
- Show storage used (in MB)
- "Clear Cache" button
---
### **7. SECURITY**
**App Lock:**
- Enable app lock: ON/OFF
- Lock method: Biometric (Fingerprint/Face) / PIN / Password
- "Change PIN/Password" button
- Auto-lock after: Immediately / 1 min / 5 min / 15 min (slider)
**Account:**
- Show email with verification status
- "Change Password" button
**Privacy:**
- Hide app content in app switcher: ON/OFF
(Blurs app preview when switching apps)
Keep it simple and secure.
---
### **8. PERMISSIONS**
Display list of permissions with status:
Show each permission:
- Icon + Name
- Status: Allowed / Denied
- Purpose/Usage
**Permissions:**
- 🎤 Microphone - For voice notes
- 🌐 Internet - For sync & backup
- 💾 Storage - For saving files
- 🔔 Notifications - For reminders
- 📅 Calendar - For syncing deadlines
- 📷 Camera - For scanning documents
- 🖼️ Photos - For uploading images
- 📁 Files - For attaching documents
"Manage in System Settings" button
---
### **9. HELP & ABOUT**
**Help Section:**
- View tutorials
- FAQs (Frequently Asked Questions)
- Contact support (email button)
- Report bug
- Send feedback
**About Section:**
- App icon
- App name
- Version number (e.g., v1.0.0)
- Developer name
- Developer email
- "Check for Updates" button
- Privacy Policy link
- Terms of Service link
**App Info:**
- App size (in MB)
- Cache size (in MB)
- Firebase connection status (Connected ✅ / Disconnected ❌)
Footer: "Made with ❤️ for Developers"
---
# 📋 **PHASE 4: TECHNICAL SPECIFICATIONS**
## **FIREBASE FIRESTORE STRUCTURE**
### **Collections:**
```
users/
{userId}/
- profile (name, email, businessName, phone, createdAt)
- settings (theme, currency, language, preferences)
projects/
{projectId}/
- userId (owner)
- projectName
- projectType
- projectIcon
- startDate
- endDate
- status
- basePrice
- description
- files[] (Google Cloud Storage URLs)
- createdAt
- updatedAt
versions/
{versionId}/
- projectId (reference)
- userId (owner)
- versionName
- versionType
- clientId (reference)
- totalCost
- amountReceived
- remainingAmount
- paymentStatus
- paymentMethod
- paymentDate
- nextPaymentDate
- invoiceNumber
- startDate
- expectedDeliveryDate
- actualDeliveryDate
- deploymentLinks {dev, staging, prod, repo}
- features[] {name, description, status, priority}
- createdAt
- updatedAt
clients/
{clientId}/
- userId (owner)
- clientName
- companyName
- email
- phone
- address
- avatar (Google Cloud Storage URL)
- totalRevenue (calculated)
- projectsCount (calculated)
- createdAt
- updatedAt
tasks/
{taskId}/
- userId (owner)
- projectId (reference)
- versionId (reference)
- clientId (reference)
- title
- description
- dueDate
- priority
- status
- reminderTime
- reminderSent (boolean)
- subTasks[] {title, completed}
- attachments[] (Google Cloud Storage URLs)
- createdAt
- updatedAt
revenue/
{revenueId}/
- userId (owner)
- projectId (reference)
- versionId (reference)
- clientId (reference)
- amount
- paymentDate
- paymentMethod
- invoiceNumber
- status
- notes
- createdAt
expenses/
{expenseId}/
- userId (owner)
- projectId (reference)
- category
- amount
- description
- date
- receipt (Google Cloud Storage URL)
- createdAt
invoices/
{invoiceId}/
- userId (owner)
- clientId (reference)
- versionId (reference)
- invoiceNumber
- invoiceDate
- dueDate
- items[]
- subtotal
- discount
- total
- status
- pdfUrl (Google Cloud Storage URL)
- sentDate
- paidDate
- createdAt
notifications/
{notificationId}/
- userId (owner)
- type
- title
- message
- read (boolean)
- relatedId
- createdAt
- actionUrl
activityLog/
{activityId}/
- userId (owner)
- type
- description
- relatedId
- metadata {}
- timestamp
```
---
## **GOOGLE CLOUD STORAGE STRUCTURE**
```
/users/{userId}/
/profile/
- avatar.jpg
/projects/{projectId}/
/documents/
/designs/
/contracts/
/versions/{versionId}/
/attachments/
/tasks/{taskId}/
/files/
/invoices/
- {invoiceId}.pdf
/expenses/
/receipts/
/backups/
- backup_YYYY-MM-DD.json
```
---
## **SUPABASE FUNCTIONS**
Create cloud functions for:
1. **onVersionCreate**
- Auto-create revenue entry
- Update client totalRevenue
- Create activity log
2. **onRevenueUpdate**
- Update client totalRevenue
- Update dashboard stats
- Check if payment complete
3. **onTaskCreate**
- Schedule notification reminder
- Add to calendar if sync enabled
4. **onTaskUpdate**
- Notify when marked done
- Update version progress
5. **scheduledDailyReminders** (Cron job)
- Check tasks due today/tomorrow
- Send notifications
- Check pending payments
6. **generateMonthlyReport** (Cron job - 1st of month)
- Generate business report
- Send email if configured
7. **calculateAnalytics** (Callable)
- Process revenue data
- Generate chart data
- Return analytics
8. **generateInvoicePDF** (Callable)
- Create PDF from template
- Upload to Google Cloud Storage
- Return URL
9. **aggregateData** (Scheduled)
- Update summary stats
- Optimize query performance
---
## **FIREBASE SECURITY RULES**
### **Firestore Rules:**
```javascript
rules_version = '2';
service cloud.firestore {
match /databases/{database}/documents {
// Users can only access their own data
match /{collection}/{document} {
allow read, write: if request.auth != null &&
resource.data.userId == request.auth.uid;
}
}
}
```
### **Storage Rules:**
```javascript
rules_version = '2';
service firebase.storage {
match /b/{bucket}/o {
match /users/{userId}/{allPaths=**} {
allow read, write: if request.auth != null &&
request.auth.uid == userId;
}
}
}
```
---
# 📋 **PHASE 5: USER FLOWS & NAVIGATION**
## **USER FLOW DIAGRAM**
```
App Launch
↓
Firebase Authentication
↓
Dashboard (Home)
│
├─→ Projects → Project Details → Versions → Version Details → Edit
├─→ Add Project → Create → Add Versions → Create Version → Save
├─→ Revenue → Analytics → Filter → Export
├─→ Clients → Client Details → Projects/Invoices/Notes
├─→ Tasks → Task Details → Edit/Complete
├─→ More → Settings / Help / Reports
└─→ Quick Actions (FAB) → Add Project/Client/Revenue/Task
```
## **NAVIGATION STRUCTURE**
**Bottom Tab Navigation:**
1. Dashboard - Home screen with overview
2. Projects - All projects list
3. Revenue - Analytics & tracking
4. Clients - Client management
5. More - Tasks, Settings, Reports, Help
**Floating Action Button (FAB):**
Available on all screens for quick actions
---
# 📋 **PHASE 6: IMPORTANT NOTES & GUIDELINES**
## **DESIGN GUIDELINES**
1. **Keep It Simple:**
- Clean, uncluttered interface
- Easy navigation
- Clear labels and buttons
- Intuitive user experience
2. **Color Coding:**
- Green: Completed, Paid, Success
- Orange: Partial, In Progress, Warning
- Red: Unpaid, Overdue, Error
- Blue: Information, Links
- Gray: Inactive, Cancelled
3. **Responsive:**
- Work on all screen sizes
- Support both portrait and landscape
- Optimize for tablets
4. **Accessibility:**
- Proper contrast ratios
- Readable font sizes
- Support for screen readers
- Clear touch targets (minimum 44x44px)
5. **Performance:**
- Fast loading times
- Smooth animations (300ms transitions)
- Efficient data loading
- Offline mode support
- Image optimization
## **DATA VALIDATION**
**Required Fields:**
- Mark with asterisk (*)
- Show error if empty on submit
- Red border on invalid fields
**Input Validation:**
- Email: proper email format
- Phone: valid phone number
- URLs: valid URL format
- Numbers: only numeric input
- Dates: valid date selection
**Error Handling:**
- Show clear error messages
- Suggest corrections
- Don't lose user data on errors
- Implement auto-save for long forms
## **NOTIFICATIONS**
**Push Notifications:**
- Ask permission on first launch
- Send at appropriate times (not during quiet hours)
- Clear, actionable messages
- Deep links to relevant screens
**In-App Notifications:**
- Toast messages for quick feedback
- Banner notifications for important updates
- Persistent notifications for critical actions
## **OFFLINE MODE**
- Cache data locally
- Allow basic operations offline
- Sync when connection restored
- Show sync status indicator
- Handle conflicts intelligently
## **SECURITY**
- All data encrypted in transit and at rest
- Secure authentication with Firebase Auth
- App lock with biometric/PIN
- Session management
- Secure API calls
- No sensitive data in logs
---
# 📋 **PHASE 7: TESTING & LAUNCH**
## **TESTING REQUIREMENTS**
**Functional Testing:**
- All CRUD operations work
- Data syncs correctly
- Calculations accurate (revenue, expenses, etc.)
- Search and filters work
- Notifications sent properly
- Export functions work
**UI/UX Testing:**
- All screens display correctly
- Navigation smooth
- Buttons respond
- Forms validate
- Loading states show
- Error states handled
**Performance Testing:**
- App launches in <3 seconds
- Screens load in <1 second
- Smooth scrolling (60fps)
- No memory leaks
- Efficient battery usage
**Security Testing:**
- Data encrypted
- Authentication secure
- Authorization working
- No data leaks
- App lock functional
**Cross-Device Testing:**
- Test on different screen sizes
- Test on iOS and Android
- Test different OS versions
- Test with slow internet
- Test offline mode
## **LAUNCH CHECKLIST**
- [ ] All features implemented
- [ ] All bugs fixed
- [ ] Performance optimized
- [ ] Security verified
- [ ] Privacy policy ready
- [ ] Terms of service ready
- [ ] App store assets prepared
- [ ] Screenshots taken
- [ ] Description written
- [ ] Testing completed
- [ ] Backup system verified
- [ ] Analytics configured
- [ ] Crashlytics setup
---
# 🎯 **FINAL REQUIREMENTS SUMMARY**
## **MUST HAVE:**
✅ Project management with versions
✅ Client management
✅ Revenue tracking with analytics
✅ Task management with reminders
✅ Invoice generation
✅ Expense tracking
✅ Document storage
✅ Cloud backup & sync
✅ Search & filters
✅ Reports generation
✅ Multiple themes (5 total, 1 with dynamic background)
✅ Settings with all specified sections
✅ Notifications system
✅ Calendar sync
## **MUST NOT HAVE:**
❌ Tax calculations/configuration
❌ Payment gateway integrations (Stripe, Razorpay, etc.)
❌ Real-time payment processing
❌ Over-complicated features
❌ Unnecessary animations
❌ Cluttered interface
## **BACKEND STACK (CONFIRMED):**
✅ Firebase Firestore - Structured data
✅ Google Cloud Storage - Large files
✅ Google Drive - File storage & sync
✅ Firebase Authentication - User auth
✅ Supabase Functions - Cloud functions
✅ Firebase Crashlytics - Crash reporting
✅ Firebase Remote Config - Feature flags
✅ Firebase Analytics - Usage tracking
## **LANGUAGE & CURRENCY:**
✅ Languages: English (India), Hinglish
✅ Default Currency: Indian Rupee (₹)
✅ Supported: INR, USD
---
# 🚀 **BUILD INSTRUCTIONS FOR AI STUDIO**
**You are tasked with building this complete application. Follow these guidelines:**
1. **Architecture First:**
- Set up backend (Firebase, Google Cloud Storage, Supabase)
- Implement authentication
- Create database structure
- Set up security rules
2. **Core Features:**
- Build dashboard first
- Implement project management
- Add version management (most critical)
- Implement client management
- Add revenue tracking
- Build task system
3. **Additional Features:**
- Invoice generator
- Expense tracker
- Document vault
- Reports
- Search
4. **Settings & Customization:**
- Implement all 9 settings sections
- Create 5 unique themes (1 with dynamic background)
- Add preferences
5. **Polish:**
- Optimize performance
- Test thoroughly
- Fix bugs
- Ensure smooth UX
6. **Think Intelligently:**
- Make smart decisions where specifications are not detailed
- Implement best practices
- Optimize for mobile
- Ensure data integrity
- Handle edge cases
- Provide great user experience
**Build a production-ready, professional app that developers will love to use!** 🎯
---
**END OF PROMPT**

RAW Paste Data Copied

# 🚀 COMPLETE APP DEVELOPMENT PROMPT - CLIENT & PROJECT MANAGEMENT SYSTEM

## 📱 **APP OVERVIEW**

**App Name:** ClientFlow Pro / DevManage Hub

**Purpose:** A personal project and client management app for developers/freelancers to manage projects, clients, versions, tasks, payments, and revenue tracking.

**Target User:** Individual developers, freelancers, small agencies

**Platform:** Mobile App (iOS & Android)

**Languages:** English (India), Hinglish

**Default Currency:** Indian Rupee (₹), with support for USD ($)

---

## 🎨 **UI/UX DESIGN REQUIREMENTS**

The app design should be: **MODERN, PROFESSIONAL, UNIQUE, HIGHLY DESIGNED, WELL ORGANISED**

### **THEMES:**

Provide **5 THEMES** in Settings. Each theme must be:
- MODERN
- PROFESSIONAL
- UNIQUE
- HIGHLY DESIGNED
- WELL ORGANISED
- COMPLETELY DIFFERENT FROM EACH OTHER IN ALL ASPECTS (colors, style, feel, layout)

**Important:** One theme MUST have **multiple color-changing effects in the background with smooth transitions** to give an amazing, phenomenon experience.

---

## 🗄️ **BACKEND ARCHITECTURE**

### **Technology Stack:**

1. **Database (Structured Data - Small):** Firebase Firestore
2. **Storage (Large Files/Data):** Google Cloud Storage
3. **File Storage & Sync:** Google Drive
4. **Authentication:** Firebase Authentication
5. **Cloud Functions:** Supabase Functions
6. **Crash Reporting:** Firebase Crashlytics
7. **Remote Configuration:** Firebase Remote Config
8. **Analytics:** Firebase Analytics

### **Data Structure Guidelines:**

- Use Firebase Firestore for: user profiles, projects, clients, versions, tasks, revenue records, settings
- Use Google Cloud Storage for: large files, attachments, documents, images, backups
- Use Google Drive for: user data sync and cloud storage
- Implement real-time sync across all devices
- Auto-backup to cloud daily

---

# 📋 **PHASE 1: CORE FEATURES & MODULES**

## **MODULE 1: DASHBOARD (Home Screen)**

### **Dashboard Components:**

**Quick Stats Cards:**
- Total Revenue (this month with percentage change)
- Active Projects (count)
- Total Clients (count)
- Pending Tasks (count with badge)

**Revenue Graph:**
- Monthly revenue bar chart (last 6 months)
- Tap to expand for detailed view
- Color-coded by project

**Recent Activity Feed:**
- Last 10 activities with timestamps
- Types: Project created, Payment received, Task completed, Client added
- Filter option: All / Projects / Payments / Tasks

**Quick Action Button (Floating):**
- Add New Project
- Add New Client
- Add Revenue Entry
- Quick Add Task

### **Navigation:**
Bottom tab bar with:
- 🏠 Dashboard
- 📱 Projects
- 💰 Revenue
- 👥 Clients
- ⋯ More

---

## **MODULE 2: PROJECTS MANAGEMENT**

### **Add Project Flow:**

**Create Project Screen - Fields:**
- Project Name* (required)
- Project Type: Website / App / Both / Other (dropdown)
- Project Icon (image picker or icon library)
- Start Date* (date picker)
- Expected End Date (date picker)
- Project Status: Active / On Hold / Completed / Cancelled (dropdown)
- Base Price (number input with currency)
- Project Description (multi-line text)
- Attach Files (documents, designs, contracts)

**Save & Continue to Versions**

### **Project Detail Screen:**

**Header:**
- Project icon + name
- Status badge (color-coded)
- Edit / Delete / Share buttons

**Tabs:**
1. **Versions** - List of all versions for this project
2. **Files** - All attached files
3. **Notes** - Project notes
4. **Timeline** - Visual timeline of project

### **Versions Tab - Most Important:**

**Version List Display:**
Each version card shows:
- Version number/name (e.g., v1.0 - Basic)
- Client name (tappable)
- Revenue badge: ₹XX,XXX (color: Green=Paid, Orange=Partial, Red=Unpaid)
- Features count (e.g., "8 features")
- Task progress bar (e.g., "5/8 completed")
- Quick actions: View / Edit / Duplicate

**Add New Version Button**

---

## **MODULE 3: VERSION MANAGEMENT (CRITICAL FEATURE)**

### **Create Version Screen - Sections:**

**1. VERSION DETAILS:**
- Version Number/Name* (e.g., v1.0)
- Version Type: Free / Basic / Premium / Custom

**2. CLIENT INFORMATION:**
- Select Existing Client (dropdown with search)
- OR Add New Client:
  - Client Name*
  - Company Name
  - Email
  - Phone
  - Address
  - Client Avatar

**3. REVENUE DETAILS:**
- Total Project Cost* (number input)
- Amount Received (number input)
- Remaining Amount (auto-calculated, red if pending)
- Payment Status: Paid / Partial / Unpaid / Pending
- Payment Method: Bank Transfer / Cash / UPI / PayPal / Other
- Payment Date (date picker)
- Next Payment Date (for partial payments)
- Invoice Number (text input)
- Payment reminder toggle

**4. FEATURES INCLUDED:**
- Add Feature button
- Each feature has:
  - Feature name*
  - Description
  - Status: Planned / In Progress / Completed / Dropped
  - Priority: Low / Medium / High / Critical
  - Delete option

**Feature Templates Library:**
Pre-defined features user can quickly add:
- User Authentication
- Admin Panel
- Payment Integration
- Push Notifications
- Responsive Design
- SEO Optimization
- Database Integration
- API Development
- (User can customize this library)

**5. TASKS & REMINDERS:**
- Add Task button
- Each task has:
  - Task Title*
  - Description
  - Due Date & Time
  - Priority: Low / Medium / High / Urgent
  - Status: To Do / In Progress / Done
  - Reminder: 15 min / 1 hour / 1 day / Custom before due
  - Checklist items (sub-tasks with checkboxes)
  - Attach files

**Task Views:**
- List View
- Board View (To Do | In Progress | Done)
- Calendar View

**6. TIMELINE:**
- Version Start Date*
- Expected Delivery Date*
- Actual Delivery Date

**7. DEPLOYMENT LINKS:**
- Development URL
- Staging URL
- Production/Live URL
- GitHub Repo Link
- Quick copy & open buttons for each

**8. ATTACHMENTS:**
- Upload documents, designs, contracts
- File preview support
- Stored in Google Cloud Storage

**Buttons:** Cancel / Save as Draft / Create Version

---

## **MODULE 4: REVENUE SECTION**

### **Revenue Dashboard:**

**Summary Cards:**
- Total Revenue (All Time)
- This Month Revenue (with % change)
- This Quarter Revenue
- Pending Payments (amount + client count)
- Average Project Value

**Filter Section:**
- Date Range: Custom / This Week / Month / Quarter / Year / All Time
- Project Filter (multi-select)
- Client Filter (multi-select)
- Payment Status Filter
- Export Button (Excel / CSV / PDF)

**Visual Analytics:**

1. **Revenue Trend Graph**
   - Line/Bar chart
   - Monthly/Quarterly/Yearly toggle
   - Interactive (tap for exact values)

2. **Revenue by Project (Pie Chart)**
   - Color-coded
   - Percentage contribution
   - Tap to drill down

3. **Revenue by Client (Bar Chart)**
   - Top 10 clients ranked
   - Total revenue per client

4. **Payment Status Distribution (Donut Chart)**
   - Paid (Green)
   - Partial (Orange)
   - Unpaid (Red)
   - Pending (Yellow)

5. **Monthly Comparison Table**
   - Month | Revenue | Projects | Avg/Project | Growth %

**Revenue Transactions List:**
Sortable/Filterable table with:
- Date
- Client Name
- Project Name
- Version
- Amount
- Payment Method
- Status
- Invoice (download/view)
- Actions: Edit / Delete / Mark Paid

**Swipe Actions:**
- Swipe right: Mark as Paid
- Swipe left: Delete

**Insights Summary Cards:**
Auto-generated insights like:
- "Best month: March 2024 - ₹XX,XXX"
- "Revenue up 45% vs last quarter"
- "3 pending payments: ₹XX,XXX total"
- "Average project value: ₹XX,XXX"
- "Top client: [Name] - ₹XX,XXX"

---

## **MODULE 5: CLIENTS MANAGEMENT**

### **Clients List Screen:**

**Search & Sort:**
- Search by name/company/email
- Sort by: Revenue / Alphabetical / Recent / Projects Count

**Client Card Display:**
- Avatar/Logo
- Client Name
- Company Name
- Projects Count | Total Revenue
- Email
- Phone
- Quick Actions: View / Contact / Invoice

### **Client Detail Screen - Tabs:**

**1. Overview:**
- Contact information (editable)
- Total revenue
- Active/Completed projects count
- Payment history summary
- Quick contact: Call / Email / WhatsApp buttons

**2. Projects:**
- List all projects/versions for this client
- Add New Project button

**3. Invoices:**
- All invoices list
- Generate new invoice
- Send via email

**4. Notes:**
- Meeting notes
- Requirements
- Communication log
- Voice notes support

**5. Activity:**
- Timeline of all interactions
- Payments, projects, messages

---

## **MODULE 6: TASKS & REMINDERS**

### **Tasks Screen:**

**View Modes:**
- List View
- Kanban Board (To Do | In Progress | Done)
- Calendar View
- Priority View

**Filters:**
- All Tasks
- By Project
- By Client
- By Priority
- By Due Date
- Overdue Only
- Completed

**Task Card Elements:**
- Priority indicator (color-coded)
- Task title
- Project name
- Client name
- Due date & time
- Progress bar (if has sub-tasks)
- Sub-tasks checklist
- Buttons: Mark Done / Edit / Delete / Snooze

**Notification System:**
Push notifications for:
- Task due soon
- Payment due
- Project deadline approaching
- Payment received
- Custom reminders

---

# 📋 **PHASE 2: ADDITIONAL FEATURES**

## **FEATURE 1: Invoice Generator**

- Professional invoice templates
- Auto-populate from version/payment data
- Customizable fields
- Add discounts
- Show payment method info from settings
- Preview before generating
- Download as PDF
- Send via email directly
- Track status: Draft / Sent / Viewed / Paid

## **FEATURE 2: Expense Tracker**

Track project-related expenses:
- Hosting costs
- Domain purchases
- API costs
- Software subscriptions
- Freelancer payments

**Categories:**
- Infrastructure
- Development Tools
- Marketing
- Outsourcing
- Miscellaneous

**Show:**
- Total expenses
- Net Profit = Revenue - Expenses
- Expense breakdown charts

## **FEATURE 3: Time Tracker**

- Built-in timer for tasks
- Manual time entry
- Time logged per project/version
- Hourly rate calculator
- Generate timesheets
- Export time reports

## **FEATURE 4: Document Vault**

- Store contracts, NDAs, agreements
- Organize by client/project
- Quick search
- Tag system
- Secure with app lock
- Store in Google Drive

## **FEATURE 5: Templates Library**

User can save and reuse:
- Project templates
- Feature sets
- Pricing packages
- Email templates
- Proposal templates
- Contract templates

## **FEATURE 6: Goals & Targets**

Set and track:
- Monthly revenue goal
- Quarterly revenue goal
- Annual revenue goal
- Project count target
- Client acquisition target

Show:
- Progress bars
- Achievement percentage
- Notifications when goals achieved

## **FEATURE 7: Reports Generator**

Generate and export:

1. **Monthly Business Report:**
   - Revenue summary
   - Project summary
   - Client summary
   - Top performers

2. **Client Report:**
   - Per-client analysis
   - Project history
   - Payment history

3. **Project Performance:**
   - Time vs estimate
   - Profitability
   - Completion rate

Export as: PDF / Excel
Schedule: Auto-generate monthly

## **FEATURE 8: Search & Filter**

- Global search across all modules
- Search: projects, clients, tasks, payments
- Advanced filters
- Recent searches
- Search suggestions

## **FEATURE 9: Backup & Sync**

- Auto-backup to Google Drive (daily)
- Manual backup option
- Restore from backup
- Export all data (JSON / Excel)
- Sync across devices in real-time

---

# 📋 **PHASE 3: SETTINGS MODULE**

## **SETTINGS STRUCTURE**

Create organized settings with these sections:

### **1. BUSINESS PROFILE**

Fields to save:
- Business logo (upload/change/remove)
- Business name*
- Tagline
- Email*
- Phone number
- WhatsApp number (checkbox: same as phone)
- Website URL
- Address: Street, City, State, PIN, Country (dropdown for country)
- Digital signature (upload / draw / clear)

Simple form layout with save button.

---

### **2. REGION & FORMAT**

**Language:**
- English (India) - Default
- Hinglish

**Currency:**
- Indian Rupee (₹) - Default
- US Dollar ($)
- Euro (€)
- British Pound (£)

**Currency Display:**
- Symbol format: ₹1,234.56
- Code format: INR 1,234.56

**Thousand Separator:**
- Comma (1,234,567)
- None (1234567)

**Indian Numbering System:**
- Toggle ON/OFF
- When ON: 12,34,567
- When OFF: 1,234,567

**Date Format:**
- DD/MM/YYYY (default for India)
- MM/DD/YYYY
- YYYY-MM-DD

**Time Format:**
- 12-hour (AM/PM) - default
- 24-hour

**Week Starts On:**
- Sunday (default)
- Monday

**Preview Section:**
Show preview of selected formats:
- Currency: ₹12,34,567
- Date: 28/12/2024
- Time: 05:30 PM

---

### **3. PROJECT DEFAULTS**

Default settings for new projects:

**Project Settings:**
- Default project type: Website / Mobile App / Both
- Default status: Active / Planning / On Hold
- Default duration: 7 / 15 / 30 / 60 / 90 days

**Version Settings:**
- Version naming: v1.0, v2.0 / v1, v2 / Basic, Premium
- Auto-increment version: ON/OFF

**Sorting Preferences:**
- Default project sort: Recently Updated / Name / Date
- Default client sort: Revenue / Name / Recent
- Default task sort: Due Date / Priority / Recent

Simple dropdowns and toggles.

---

### **4. PAYMENT METHODS**

Store payment information (displayed on invoices):

**Bank Transfer:**
- Enable/Disable toggle
- Bank name
- Account holder name
- Account number (with show/hide)
- IFSC/Routing code
- Account type: Savings / Current

**UPI:**
- Enable/Disable toggle
- UPI ID
- Generate QR code button

**Cash:**
- Enable/Disable toggle

**PayPal:**
- Enable/Disable toggle
- PayPal email

**Invoice Settings:**
- Invoice prefix (text: e.g., "INV")
- Starting number (e.g., "001")
- Preview display: INV-001
- Payment terms: Due immediately / 7 days / 15 days / 30 days / 60 days

---

### **5. NOTIFICATIONS**

**Master Control:**
- Enable all notifications: ON/OFF

**Notify me for:**
- Task reminders ☐
- Payment due ☐
- Project deadlines ☐
- Payment received ☐
- Daily summary ☐
- Weekly report ☐

**Notification Style:**
- Sound: ON/OFF
- Vibration: ON/OFF
- Show on lock screen: ON/OFF

**Quiet Hours:**
- Enable: ON/OFF
- From: (time picker) 11:00 PM
- To: (time picker) 08:00 AM

**Reminder Defaults:**
- Remind before: 15 min / 1 hour / 1 day / At due time

**Calendar Sync:**
- Sync with device calendar: ON/OFF
- What to sync:
  - Task deadlines ☐
  - Project deadlines ☐
  - Payment due dates ☐
- "Sync Now" button

---

### **6. BACKUP & DATA**

**Cloud Backup:**
- Auto backup: ON/OFF
- Backup frequency: Daily / Weekly / Manual only
- Backup only on WiFi: ON/OFF
- Last backup: (show date & time)
- Backup size: (show in MB)
- "Backup Now" button

**Restore:**
- List of available backups (show date)
- Each has: "Restore" button / "Delete" button

**Export Data:**
- Export format: Excel / CSV / PDF
- "Export All Data" button
- Saves to device downloads folder

**Storage:**
- Show storage used (in MB)
- "Clear Cache" button

---

### **7. SECURITY**

**App Lock:**
- Enable app lock: ON/OFF
- Lock method: Biometric (Fingerprint/Face) / PIN / Password
- "Change PIN/Password" button
- Auto-lock after: Immediately / 1 min / 5 min / 15 min (slider)

**Account:**
- Show email with verification status
- "Change Password" button

**Privacy:**
- Hide app content in app switcher: ON/OFF
  (Blurs app preview when switching apps)

Keep it simple and secure.

---

### **8. PERMISSIONS**

Display list of permissions with status:

Show each permission:
- Icon + Name
- Status: Allowed / Denied
- Purpose/Usage

**Permissions:**
- 🎤 Microphone - For voice notes
- 🌐 Internet - For sync & backup
- 💾 Storage - For saving files
- 🔔 Notifications - For reminders
- 📅 Calendar - For syncing deadlines
- 📷 Camera - For scanning documents
- 🖼️ Photos - For uploading images
- 📁 Files - For attaching documents

"Manage in System Settings" button

---

### **9. HELP & ABOUT**

**Help Section:**
- View tutorials
- FAQs (Frequently Asked Questions)
- Contact support (email button)
- Report bug
- Send feedback

**About Section:**
- App icon
- App name
- Version number (e.g., v1.0.0)
- Developer name
- Developer email
- "Check for Updates" button
- Privacy Policy link
- Terms of Service link

**App Info:**
- App size (in MB)
- Cache size (in MB)
- Firebase connection status (Connected ✅ / Disconnected ❌)

Footer: "Made with ❤️ for Developers"

---

# 📋 **PHASE 4: TECHNICAL SPECIFICATIONS**

## **FIREBASE FIRESTORE STRUCTURE**

### **Collections:**

```
users/
  {userId}/
    - profile (name, email, businessName, phone, createdAt)
    - settings (theme, currency, language, preferences)

projects/
  {projectId}/
    - userId (owner)
    - projectName
    - projectType
    - projectIcon
    - startDate
    - endDate
    - status
    - basePrice
    - description
    - files[] (Google Cloud Storage URLs)
    - createdAt
    - updatedAt

versions/
  {versionId}/
    - projectId (reference)
    - userId (owner)
    - versionName
    - versionType
    - clientId (reference)
    - totalCost
    - amountReceived
    - remainingAmount
    - paymentStatus
    - paymentMethod
    - paymentDate
    - nextPaymentDate
    - invoiceNumber
    - startDate
    - expectedDeliveryDate
    - actualDeliveryDate
    - deploymentLinks {dev, staging, prod, repo}
    - features[] {name, description, status, priority}
    - createdAt
    - updatedAt

clients/
  {clientId}/
    - userId (owner)
    - clientName
    - companyName
    - email
    - phone
    - address
    - avatar (Google Cloud Storage URL)
    - totalRevenue (calculated)
    - projectsCount (calculated)
    - createdAt
    - updatedAt

tasks/
  {taskId}/
    - userId (owner)
    - projectId (reference)
    - versionId (reference)
    - clientId (reference)
    - title
    - description
    - dueDate
    - priority
    - status
    - reminderTime
    - reminderSent (boolean)
    - subTasks[] {title, completed}
    - attachments[] (Google Cloud Storage URLs)
    - createdAt
    - updatedAt

revenue/
  {revenueId}/
    - userId (owner)
    - projectId (reference)
    - versionId (reference)
    - clientId (reference)
    - amount
    - paymentDate
    - paymentMethod
    - invoiceNumber
    - status
    - notes
    - createdAt

expenses/
  {expenseId}/
    - userId (owner)
    - projectId (reference)
    - category
    - amount
    - description
    - date
    - receipt (Google Cloud Storage URL)
    - createdAt

invoices/
  {invoiceId}/
    - userId (owner)
    - clientId (reference)
    - versionId (reference)
    - invoiceNumber
    - invoiceDate
    - dueDate
    - items[]
    - subtotal
    - discount
    - total
    - status
    - pdfUrl (Google Cloud Storage URL)
    - sentDate
    - paidDate
    - createdAt

notifications/
  {notificationId}/
    - userId (owner)
    - type
    - title
    - message
    - read (boolean)
    - relatedId
    - createdAt
    - actionUrl

activityLog/
  {activityId}/
    - userId (owner)
    - type
    - description
    - relatedId
    - metadata {}
    - timestamp
```

---

## **GOOGLE CLOUD STORAGE STRUCTURE**

```
/users/{userId}/
  /profile/
    - avatar.jpg
  /projects/{projectId}/
    /documents/
    /designs/
    /contracts/
  /versions/{versionId}/
    /attachments/
  /tasks/{taskId}/
    /files/
  /invoices/
    - {invoiceId}.pdf
  /expenses/
    /receipts/
  /backups/
    - backup_YYYY-MM-DD.json
```

---

## **SUPABASE FUNCTIONS**

Create cloud functions for:

1. **onVersionCreate**
   - Auto-create revenue entry
   - Update client totalRevenue
   - Create activity log

2. **onRevenueUpdate**
   - Update client totalRevenue
   - Update dashboard stats
   - Check if payment complete

3. **onTaskCreate**
   - Schedule notification reminder
   - Add to calendar if sync enabled

4. **onTaskUpdate**
   - Notify when marked done
   - Update version progress

5. **scheduledDailyReminders** (Cron job)
   - Check tasks due today/tomorrow
   - Send notifications
   - Check pending payments

6. **generateMonthlyReport** (Cron job - 1st of month)
   - Generate business report
   - Send email if configured

7. **calculateAnalytics** (Callable)
   - Process revenue data
   - Generate chart data
   - Return analytics

8. **generateInvoicePDF** (Callable)
   - Create PDF from template
   - Upload to Google Cloud Storage
   - Return URL

9. **aggregateData** (Scheduled)
   - Update summary stats
   - Optimize query performance

---

## **FIREBASE SECURITY RULES**

### **Firestore Rules:**

```javascript
rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    // Users can only access their own data
    match /{collection}/{document} {
      allow read, write: if request.auth != null && 
        resource.data.userId == request.auth.uid;
    }
  }
}
```

### **Storage Rules:**

```javascript
rules_version = '2';
service firebase.storage {
  match /b/{bucket}/o {
    match /users/{userId}/{allPaths=**} {
      allow read, write: if request.auth != null && 
        request.auth.uid == userId;
    }
  }
}
```

---

# 📋 **PHASE 5: USER FLOWS & NAVIGATION**

## **USER FLOW DIAGRAM**

```
App Launch
    ↓
Firebase Authentication
    ↓
Dashboard (Home)
    │
    ├─→ Projects → Project Details → Versions → Version Details → Edit
    ├─→ Add Project → Create → Add Versions → Create Version → Save
    ├─→ Revenue → Analytics → Filter → Export
    ├─→ Clients → Client Details → Projects/Invoices/Notes
    ├─→ Tasks → Task Details → Edit/Complete
    ├─→ More → Settings / Help / Reports
    └─→ Quick Actions (FAB) → Add Project/Client/Revenue/Task
```

## **NAVIGATION STRUCTURE**

**Bottom Tab Navigation:**
1. Dashboard - Home screen with overview
2. Projects - All projects list
3. Revenue - Analytics & tracking
4. Clients - Client management
5. More - Tasks, Settings, Reports, Help

**Floating Action Button (FAB):**
Available on all screens for quick actions

---

# 📋 **PHASE 6: IMPORTANT NOTES & GUIDELINES**

## **DESIGN GUIDELINES**

1. **Keep It Simple:**
   - Clean, uncluttered interface
   - Easy navigation
   - Clear labels and buttons
   - Intuitive user experience

2. **Color Coding:**
   - Green: Completed, Paid, Success
   - Orange: Partial, In Progress, Warning
   - Red: Unpaid, Overdue, Error
   - Blue: Information, Links
   - Gray: Inactive, Cancelled

3. **Responsive:**
   - Work on all screen sizes
   - Support both portrait and landscape
   - Optimize for tablets

4. **Accessibility:**
   - Proper contrast ratios
   - Readable font sizes
   - Support for screen readers
   - Clear touch targets (minimum 44x44px)

5. **Performance:**
   - Fast loading times
   - Smooth animations (300ms transitions)
   - Efficient data loading
   - Offline mode support
   - Image optimization

## **DATA VALIDATION**

**Required Fields:**
- Mark with asterisk (*)
- Show error if empty on submit
- Red border on invalid fields

**Input Validation:**
- Email: proper email format
- Phone: valid phone number
- URLs: valid URL format
- Numbers: only numeric input
- Dates: valid date selection

**Error Handling:**
- Show clear error messages
- Suggest corrections
- Don't lose user data on errors
- Implement auto-save for long forms

## **NOTIFICATIONS**

**Push Notifications:**
- Ask permission on first launch
- Send at appropriate times (not during quiet hours)
- Clear, actionable messages
- Deep links to relevant screens

**In-App Notifications:**
- Toast messages for quick feedback
- Banner notifications for important updates
- Persistent notifications for critical actions

## **OFFLINE MODE**

- Cache data locally
- Allow basic operations offline
- Sync when connection restored
- Show sync status indicator
- Handle conflicts intelligently

## **SECURITY**

- All data encrypted in transit and at rest
- Secure authentication with Firebase Auth
- App lock with biometric/PIN
- Session management
- Secure API calls
- No sensitive data in logs

---

# 📋 **PHASE 7: TESTING & LAUNCH**

## **TESTING REQUIREMENTS**

**Functional Testing:**
- All CRUD operations work
- Data syncs correctly
- Calculations accurate (revenue, expenses, etc.)
- Search and filters work
- Notifications sent properly
- Export functions work

**UI/UX Testing:**
- All screens display correctly
- Navigation smooth
- Buttons respond
- Forms validate
- Loading states show
- Error states handled

**Performance Testing:**
- App launches in <3 seconds
- Screens load in <1 second
- Smooth scrolling (60fps)
- No memory leaks
- Efficient battery usage

**Security Testing:**
- Data encrypted
- Authentication secure
- Authorization working
- No data leaks
- App lock functional

**Cross-Device Testing:**
- Test on different screen sizes
- Test on iOS and Android
- Test different OS versions
- Test with slow internet
- Test offline mode

## **LAUNCH CHECKLIST**

- [ ] All features implemented
- [ ] All bugs fixed
- [ ] Performance optimized
- [ ] Security verified
- [ ] Privacy policy ready
- [ ] Terms of service ready
- [ ] App store assets prepared
- [ ] Screenshots taken
- [ ] Description written
- [ ] Testing completed
- [ ] Backup system verified
- [ ] Analytics configured
- [ ] Crashlytics setup

---

# 🎯 **FINAL REQUIREMENTS SUMMARY**

## **MUST HAVE:**
✅ Project management with versions
✅ Client management
✅ Revenue tracking with analytics
✅ Task management with reminders
✅ Invoice generation
✅ Expense tracking
✅ Document storage
✅ Cloud backup & sync
✅ Search & filters
✅ Reports generation
✅ Multiple themes (5 total, 1 with dynamic background)
✅ Settings with all specified sections
✅ Notifications system
✅ Calendar sync

## **MUST NOT HAVE:**
❌ Tax calculations/configuration
❌ Payment gateway integrations (Stripe, Razorpay, etc.)
❌ Real-time payment processing
❌ Over-complicated features
❌ Unnecessary animations
❌ Cluttered interface

## **BACKEND STACK (CONFIRMED):**
✅ Firebase Firestore - Structured data
✅ Google Cloud Storage - Large files
✅ Google Drive - File storage & sync
✅ Firebase Authentication - User auth
✅ Supabase Functions - Cloud functions
✅ Firebase Crashlytics - Crash reporting
✅ Firebase Remote Config - Feature flags
✅ Firebase Analytics - Usage tracking

## **LANGUAGE & CURRENCY:**
✅ Languages: English (India), Hinglish
✅ Default Currency: Indian Rupee (₹)
✅ Supported: INR, USD

---

# 🚀 **BUILD INSTRUCTIONS FOR AI STUDIO**

**You are tasked with building this complete application. Follow these guidelines:**

1. **Architecture First:**
   - Set up backend (Firebase, Google Cloud Storage, Supabase)
   - Implement authentication
   - Create database structure
   - Set up security rules

2. **Core Features:**
   - Build dashboard first
   - Implement project management
   - Add version management (most critical)
   - Implement client management
   - Add revenue tracking
   - Build task system

3. **Additional Features:**
   - Invoice generator
   - Expense tracker
   - Document vault
   - Reports
   - Search

4. **Settings & Customization:**
   - Implement all 9 settings sections
   - Create 5 unique themes (1 with dynamic background)
   - Add preferences

5. **Polish:**
   - Optimize performance
   - Test thoroughly
   - Fix bugs
   - Ensure smooth UX

6. **Think Intelligently:**
   - Make smart decisions where specifications are not detailed
   - Implement best practices
   - Optimize for mobile
   - Ensure data integrity
   - Handle edge cases
   - Provide great user experience

**Build a production-ready, professional app that developers will love to use!** 🎯

---

**END OF PROMPT**