Health Notes

A simple iOS app for tracking your daily health symptoms, medications, and notes. Built with Flutter and designed to feel native on iPhone (Cupertino Widgets). Most of the code was written by Cursor.

What is Health Notes?

Health Notes helps you keep track of your health over time. You can:

• Record symptoms, medications, and notes with timestamps
• View trends and patterns in your health data
• Keep your data private and secure
• Access your notes from any device

Quick Start

Prerequisites

• Flutter SDK installed
• iOS Simulator or iPhone for testing
• Google account for sign-in

Get Started

1. Also see the cursor-design-docs/ dir

2. Clone and install dependencies

   git clone <repository-url>
   cd health_notes
   flutter pub get

3. Set up your environment

   • Create a .env file in the project root
   • Add your Supabase and Google OAuth credentials (see setup guide below)

4. Generate code

   flutter packages pub run build_runner build

5. Run the app

   flutter run

Setup Guide

1. Supabase Setup

1. Create a new project at supabase.com
2. Run the SQL commands from supabase_setup.sql in your Supabase SQL Editor
3. Get your project URL and anon key from Settings > API

2. Google OAuth Setup

1. Go to Google Cloud Console
2. Create a new project or select existing one
3. Enable Google Sign-In API
4. Create OAuth 2.0 credentials for iOS
5. Add your bundle identifier (found in ios/Runner/Info.plist)

3. Environment Configuration

Create a .env file in the project root:

URL=your_supabase_project_url
ANON_KEY=your_supabase_anon_key
GOOGLE_WEB_CLIENT_ID=your_google_client_id

Running on Your iPhone

Option 1: Simple Deployment

./deploy_to_iphone

Option 2: Manual Deployment

flutter run --device-id=your_iphone_id

Note: Make sure your iPhone is in Developer Mode and you've trusted your Mac.

Running in Simulator

./deploy_to_simulator

Features

• 🔐 Secure Sign-in: Use your Google account to sign in
• 📱 Native iOS Design: Feels like a built-in iPhone app
• 📊 Health Trends: See patterns in your symptoms over time
• 🔒 Private Data: Your health notes are private and secure
• 📅 Easy Date Selection: Built-in date picker for accurate timestamps
• 🔄 Sync: Your data syncs across all your devices

Project Structure

lib/
├── models/          # Data structures
├── screens/         # App screens and UI
├── providers/       # State management
├── services/        # API and authentication
├── widgets/         # Reusable UI components
└── utils/           # Helper functions

Development

Regenerate Models

When you change data models:

flutter packages pub run build_runner build --delete-conflicting-outputs

Troubleshooting

Common Issues

"No devices found"

• Make sure your iPhone is connected via USB
• Check that Developer Mode is enabled on your iPhone
• Try disconnecting and reconnecting your device

"Build failed"

• Run flutter clean then flutter pub get
• Make sure all environment variables are set in .env

"Authentication error"

• Verify your Google OAuth credentials are correct
• Check that your bundle identifier matches in Google Cloud Console

Getting Help

• Check the scripts/README.md for detailed deployment troubleshooting
• Review the cursor-design-docs/ directory, for more documentation

App Icon

The app icon is generated from assets/icons/base_icon_img.png. To update it:

1. Replace the base image (1024x1024 PNG recommended)
2. Run ./assets/icons/generate_ios_icons.sh
3. The new icons will be automatically generated

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

License

None.