iOS Installation

Install Yooz Notes on your iPhone or iPad as a Progressive Web App (PWA).

What is a PWA?

A Progressive Web App gives you an app-like experience:

• Home screen icon - Launch like a native app
• Full screen mode - No browser chrome
• Offline access - Works without internet
• Fast loading - Cached for instant startup

Requirements

• iOS 16.4 or later (for best PWA support)
• Safari browser (required for installation)
• Internet connection (for initial install only)

Installation Steps

Step 1: Open Safari

PWA installation only works in Safari. Other browsers like Chrome or Firefox cannot install PWAs on iOS.

Step 2: Navigate to Yooz Notes

Go to: yooz.live/notes

Step 3: Open Share Menu

Tap the Share button at the bottom of Safari:

• iPhone: Bottom toolbar, square with arrow pointing up
• iPad: Top toolbar, same icon

Step 4: Add to Home Screen

Scroll down in the share menu and tap "Add to Home Screen"

Can't Find It?

If you don't see "Add to Home Screen":

1. Scroll down in the share menu
2. It may be in the second row of options
3. Ensure you're using Safari (not Chrome)

Step 5: Name Your App

• Default name: "Yooz Notes"
• Edit if desired
• Tap "Add" in the top right

Step 6: Launch from Home Screen

Find the Yooz Notes icon on your home screen and tap to open.

The app now runs in full-screen mode, just like a native app.

First Launch

What to Expect

1. Full screen - No Safari toolbar
2. Same data - Notes from browser are there
3. Offline ready - Core features cached

Setting Up

1. Enable encryption if not already done
2. Check settings sync from browser
3. Create a test note

Features on iOS

What Works Great

Feature	Status	Notes
Note creation	Excellent	Full editor support
Markdown	Excellent	All formatting
Tags	Excellent	Full filtering
Encryption	Excellent	Full security
Offline mode	Excellent	Works without internet
Mermaid diagrams	Excellent	Full rendering
Copy/paste	Excellent	System integration

iOS-Specific Behaviors

• Keyboard shortcuts - Limited to on-screen keyboard
• Share extension - Not available (PWA limitation)
• Notifications - Not supported on iOS PWAs
• Background sync - Requires app to be open

Offline Usage

How It Works

Once installed, Yooz Notes works offline:

1. App shell cached - UI loads instantly
2. Notes stored locally - IndexedDB persistence
3. No server needed - Everything local

Offline Limitations

• Cannot sync (when sync feature arrives)
• Cannot access web links in notes
• New PWA updates require online access

Data Storage

Where Notes Live

Your notes are stored in:

• Safari's IndexedDB storage
• Linked to the PWA installation
• Persists across app restarts

Storage Limits

iOS allocates storage per origin:

Condition	Storage Limit
Normal	Up to 1GB
Low disk space	May be reduced
Private browsing	Session only (don't use)

Private Browsing

Never use Yooz Notes in private browsing mode. Notes will be deleted when you close the browser.

Updating the App

Automatic Updates

PWAs update automatically when:

1. You have internet access
2. The app is opened
3. A new version is available

Manual Update

Force an update:

1. Close Yooz Notes completely
2. Reconnect to internet
3. Open the app
4. Wait a few seconds for update

Checking Version

Look in Settings within the app for version information.

Troubleshooting

App Won't Install

Problem: "Add to Home Screen" doesn't appear

Solutions:

1. Ensure you're using Safari (not Chrome/Firefox)
2. Navigate directly to yooz.live/notes
3. Try refreshing the page
4. Update iOS to 16.4+

Notes Not Appearing

Problem: Notes from browser missing in PWA

Solutions:

1. Both use same Safari profile
2. Not using private browsing
3. Try closing and reopening
4. Check you're on same device

App Won't Open

Problem: Icon taps but nothing happens

Solutions:

1. Wait a few seconds
2. Check internet connection for first load
3. Delete and reinstall the PWA
4. Restart your device

Keyboard Issues

Problem: Keyboard covers editor

Solutions:

1. Scroll up in the note
2. Try landscape orientation
3. Tap outside to dismiss keyboard

Storage Full

Problem: Can't create new notes

Solutions:

1. Delete old notes you don't need
2. Clear Safari website data (last resort)
3. Check iOS storage settings

Removing the App

Delete from Home Screen

1. Long-press the Yooz Notes icon
2. Tap "Remove App" or the minus icon
3. Confirm deletion

Data Removal

Removing the PWA may delete your notes. Export important notes first if you have encryption enabled and plan to reinstall.

Keeping Data

To reinstall without losing data:

1. Don't clear Safari website data
2. Reinstall the PWA
3. Notes should still be there

Tips for iOS

Best Practices

1. Enable encryption - Protect your notes
2. Don't use private mode - Data won't persist
3. Regular updates - Open online periodically
4. Export backups - Use export feature when available

iPad-Specific

• Split View - Works in multitasking
• External keyboard - Full shortcut support
• Apple Pencil - Standard text input works

iPhone-Specific

• Face ID/Touch ID - Works with device authentication
• Control Center - Quick access via home screen
• Widget - Not available (PWA limitation)

Comparison: PWA vs Browser

Aspect	PWA	Browser
Launch speed	Faster	Slower
Full screen	Yes	No
Home screen icon	Yes	Bookmark only
Offline	Better	Limited
Updates	Automatic	Immediate
Storage	Dedicated	Shared

Privacy on iOS

Data Location

• Notes stored in app sandbox
• Encrypted at rest (iOS encryption)
• Additional encryption with master password

No Tracking

• No analytics collected
• No data sent to servers
• Fully local operation

Learn More

• Offline Mode
• Encryption
• Android Installation