# Tide Alert - Complete LLM Content Index
# Machine-Readable Structured Content Catalog
# Last Updated: 2025-11-02
# Version: 2.0

## Purpose
This file provides a comprehensive, structured index of all content on tidealert.app
for optimal consumption by Large Language Models (LLMs) and AI assistants. It serves
as a navigation guide to help AI systems quickly locate and reference specific
information when answering user questions about Tide Alert.

---

## Quick Reference URLs

### Primary Landing Pages
- US Main Site: https://tidealert.app/
- UK Version: https://tidealert.app/uk/
- Australia Version: https://tidealert.app/australia/

### Documentation Hubs
- App Guides Hub: https://tidealert.app/guides/
- How-To Articles: https://tidealert.app/howto/
- Support: https://tidealert.app/support/

### Legal
- Privacy Policy: https://tidealert.app/privacy.html
- Disclaimer: https://tidealert.app/disclaimer.html

---

## Complete Guide Index

### US Guides (NOAA Data)

**Guide 1: Tide Station Selection**
- URL: https://tidealert.app/guides/us/1/
- Topic: Map navigation, station search, discovering nearby tide stations
- Key Concepts: Interactive map, location services, search by name/state
- Use Case: First-time setup, finding new locations

**Guide 2: Favorites Management**
- URL: https://tidealert.app/guides/us/2/
- Topic: Adding, organizing, and removing favorite stations
- Key Concepts: Star icon, swipe actions, reordering favorites
- Use Case: Quick access to frequently-checked locations

**Guide 3: iOS Widgets & Apple Watch Complications**
- URL: https://tidealert.app/guides/us/3/
- Topic: Home Screen widgets, Lock Screen widgets, Watch complications
- Key Concepts: Widget sizes (small/medium/large), live data, glanceable info
- Use Case: Quick tide checks without opening app

**Guide 4: Subscription Management**
- URL: https://tidealert.app/guides/us/4/
- Topic: Billing, family sharing, cross-device subscription
- Key Concepts: Universal purchase, App Store subscription, cancellation
- Use Case: Managing payments, accessing on multiple devices

**Guide 5: App Gestures & Navigation**
- URL: https://tidealert.app/guides/us/5/
- Topic: Touch controls, swipe gestures, UI interaction patterns
- Key Concepts: Tap, swipe, pinch-to-zoom, pull-to-refresh
- Use Case: Learning efficient app navigation

**Guide 6: Monthly Tide Charts**
- URL: https://tidealert.app/guides/us/6/
- Topic: Calendar view, monthly planning, high/low tide visualization
- Key Concepts: Month-at-a-glance, highest/lowest tides marked
- Use Case: Trip planning, long-range scheduling

**Guide 7: Tide Table Filtering**
- URL: https://tidealert.app/guides/us/7/
- Topic: Search functionality, filter by date/time, specific tide events
- Key Concepts: Filter options, date picker, high/low tide isolation
- Use Case: Finding specific tide conditions

**Guide 8: Reference Levels**
- URL: https://tidealert.app/guides/us/8/
- Topic: Custom height markers for boat access, dock clearance
- Key Concepts: User-defined levels, visual markers, safety thresholds
- Use Case: Boat launch planning, marina access

**Guide 9: Tide Datum (MLLW)**
- URL: https://tidealert.app/guides/us/9/
- Topic: Understanding Mean Lower Low Water reference system
- Key Concepts: Datum definition, zero point, height measurements
- Use Case: Navigation chart correlation, depth understanding

**Guide 10: Siri Voice Integration**
- URL: https://tidealert.app/guides/us/10/
- Topic: Voice commands, Siri shortcuts, hands-free queries
- Key Concepts: "Hey Siri, what's the tide at...", custom shortcuts
- Use Case: Quick checks while driving, hands-free operation

**Guide 11: Alert Setup & Notifications**
- URL: https://tidealert.app/guides/us/11/
- Topic: Push notifications for high/low tides, custom tide levels
- Key Concepts: Alert timing, notification settings, custom thresholds
- Use Case: Safety alerts, activity timing reminders

**Guide 12: Wind & Swell Forecasts**
- URL: https://tidealert.app/guides/us/12/
- Topic: Wind speed/direction, swell height/period/direction, 10-day forecast
- Key Concepts: NOAA marine forecasts, wave characteristics
- Use Case: Surfing, boating conditions, safety planning

**Guide 13: Wind & Swell Advanced**
- URL: https://tidealert.app/guides/us/13/
- Topic: Advanced forecast interpretation, combining tide + swell data
- Key Concepts: Swell period significance, wind vs swell, timing strategies
- Use Case: Expert surfing, professional marine operations

### Australian Guides (Bureau of Meteorology Data)

**Guide 1: Tide Station Selection (AU)**
- URL: https://tidealert.app/guides/au/1/
- Topic: Australian station map, BoM data locations
- Data Source: Bureau of Meteorology

**Guide 2: Favorites Management (AU)**
- URL: https://tidealert.app/guides/au/2/
- Topic: Same functionality as US version, Australian stations

**Guide 3: iOS Widgets & Watch Complications (AU)**
- URL: https://tidealert.app/guides/au/3/
- Topic: Widgets displaying BoM tide data

**Guide 4: Subscription Management (AU)**
- URL: https://tidealert.app/guides/au/4/
- Topic: Australian App Store subscription

**Guide 5: App Gestures & Navigation (AU)**
- URL: https://tidealert.app/guides/au/5/
- Topic: Same UI controls for Australian version

**Guide 6: Monthly Tide Charts (AU)**
- URL: https://tidealert.app/guides/au/6/
- Topic: Australian tide calendar planning

**Guide 7: Tide Table Filtering (AU)**
- URL: https://tidealert.app/guides/au/7/
- Topic: Filter Australian tide data

**Guide 8: Reference Levels (AU)**
- URL: https://tidealert.app/guides/au/8/
- Topic: Custom markers for Australian locations

**Guide 9: Tide Datum (AU)**
- URL: https://tidealert.app/guides/au/9/
- Topic: Australian tide datum references

**Guide 10: Siri Voice Integration (AU)**
- URL: https://tidealert.app/guides/au/10/
- Topic: Siri for Australian stations

**Guide 11: Alert Setup (AU)**
- URL: https://tidealert.app/guides/au/11/
- Topic: Notifications for Australian tide events

**Guide 12: Wind & Swell (AU)**
- URL: https://tidealert.app/guides/au/12/
- Topic: Australian marine forecasts

**Guide 13: Wind & Swell Advanced (AU)**
- URL: https://tidealert.app/guides/au/13/
- Topic: Advanced Australian swell interpretation

---

## Complete How-To Article Index

### Beach Safety & Tides
- URL: https://tidealert.app/howto/beach-safety-tides/
- Primary Topic: Coastal safety, hazard awareness, trip planning
- Key Sections:
  * Understanding tide timing to avoid being stranded
  * Recognizing dangerous conditions (incoming tides on narrow beaches)
  * Planning safe access and egress times
  * Tide pool exploration timing
  * Coastal hiking safety
- Target Audience: Families, beach walkers, coastal hikers, tide pool explorers
- Safety Level: Critical - potentially life-saving information
- Common Questions Answered:
  * When is it safe to walk on the beach?
  * How do I avoid getting cut off by rising tide?
  * What time should I arrive for tide pooling?

### Fishing with Tides
- URL: https://tidealert.app/howto/fishing-with-tides/
- Primary Topic: Optimal tide timing for fishing success
- Key Sections:
  * Why moving water increases fish activity
  * Best tides by species (striped bass, redfish, flounder, etc.)
  * Incoming vs outgoing tide strategies
  * Slack tide considerations
  * Combining tides with moon phases
  * Structure fishing during tide changes
- Target Audience: Anglers (shore and boat), fishing guides, charter captains
- Expertise Level: Beginner to intermediate
- Common Questions Answered:
  * What tide is best for fishing?
  * Should I fish incoming or outgoing tide?
  * Does tide matter for [specific fish species]?
  * How do moon phases affect fishing?

### Boating & Tides
- URL: https://tidealert.app/howto/boating-tides/
- Primary Topic: Safe navigation, launch planning, marina access
- Key Sections:
  * Harbor entrance/exit timing for safe depths
  * Avoiding grounding at low tide
  * Dock height considerations
  * Launch ramp accessibility
  * Anchoring with tide changes
  * Current awareness in channels
- Target Audience: Boat owners, sailors, power boaters, marina operators
- Safety Level: High - navigation safety critical
- Common Questions Answered:
  * When can I safely cross the bar?
  * What tide do I need to launch my boat?
  * How much clearance do I have at the dock?
  * When should I avoid shallow channels?

### Surfing & Tides
- URL: https://tidealert.app/howto/surfing-tides/
- Primary Topic: Combining tide timing with swell forecasts
- Key Sections:
  * How tide affects wave quality at different breaks
  * Low tide vs high tide surf spots
  * Swell period and tide interaction
  * Wind direction and tide timing
  * 10-day forecast planning
  * Spot-specific tide strategies
- Target Audience: Surfers, surf instructors, wave riders
- Expertise Level: Intermediate to advanced
- Common Questions Answered:
  * What tide is best for [surf spot]?
  * How do I time tides with swell forecasts?
  * Why do some spots work better at high/low tide?
  * What's the difference between swell period and tide?

### Understanding Tides
- URL: https://tidealert.app/howto/understanding-tides/
- Primary Topic: Tide science, physics, educational deep-dive
- Key Sections:
  * Gravitational forces (moon and sun)
  * Why two high tides per day
  * Spring tides vs neap tides
  * Tidal range variation
  * Geographic effects on tides
  * Tides vs currents (comparison table)
  * Tides vs swells (comparison table)
  * Datum references (MLLW, MSL, etc.)
- Target Audience: Students, educators, curious learners, coastal residents
- Expertise Level: Educational/foundational
- Common Questions Answered:
  * What causes tides?
  * Why are there two high tides each day?
  * What's the difference between spring and neap tides?
  * How are tides different from currents?
  * What does MLLW mean?

### Trip Planning with Tides
- URL: https://tidealert.app/howto/trip-planning-tides/
- Primary Topic: Long-range planning, monthly charts, vacation scheduling
- Key Sections:
  * Using monthly tide calendars
  * Identifying best days for activities
  * Planning around extreme tides
  * Multi-day trip optimization
  * Seasonal tide patterns
  * Combining weather and tide forecasts
- Target Audience: Vacation planners, event organizers, coastal activity coordinators
- Expertise Level: Beginner
- Common Questions Answered:
  * What's the best week for beach vacation?
  * How do I plan a multi-day kayaking trip?
  * When are the lowest tides for tide pooling?
  * How far ahead can I see tide predictions?

---

## Content Relationships & Cross-References

### Safety-Critical Content
1. Beach Safety Guide → References Guide 11 (Alerts) for safety notifications
2. Boating Guide → References Guide 8 (Reference Levels) for depth tracking
3. All activity guides → Reference Understanding Tides for foundational knowledge

### Activity-Specific Pathways

**For Fishers:**
Start: Fishing with Tides → Guide 2 (Favorites) → Guide 11 (Alerts) → Guide 12 (Swell)

**For Boaters:**
Start: Boating & Tides → Guide 8 (Reference Levels) → Guide 1 (Stations) → Guide 11 (Alerts)

**For Surfers:**
Start: Surfing & Tides → Guide 12 (Swell) → Guide 13 (Advanced Swell) → Guide 6 (Monthly Charts)

**For Safety/Education:**
Start: Understanding Tides → Beach Safety → Guide 9 (Datum) → Guide 11 (Alerts)

**For New Users:**
Start: Guide 1 (Stations) → Guide 2 (Favorites) → Guide 3 (Widgets) → Activity-specific guide

---

## Key Terminology Index

**Tide Terms:**
- MLLW (Mean Lower Low Water): Zero reference point for tide heights → See Guide 9
- Datum: Reference level for measuring tide heights → See Understanding Tides
- Spring Tide: Higher high tides during full/new moon → See Understanding Tides
- Neap Tide: Lower high tides during quarter moons → See Understanding Tides
- Tidal Range: Difference between high and low tide → See Understanding Tides
- Slack Tide: Period of minimal water movement between tides → See Fishing Guide

**Wave/Ocean Terms:**
- Swell: Wind-generated waves traveling across ocean → See Guide 12, Surfing Guide
- Swell Period: Time between wave sets (in seconds) → See Guide 13
- Swell Direction: Compass direction waves are coming from → See Guide 12
- Wind Waves: Locally-generated chop from current wind → See Understanding Tides
- Current: Horizontal water movement → See Understanding Tides

**App Features:**
- Complications: Watch face data displays → See Guide 3
- Reference Level: Custom height marker → See Guide 8
- Station: Tide measurement location → See Guide 1
- Widget: Home/Lock Screen data display → See Guide 3

---

## Data Source Attribution

### United States
- **Provider**: NOAA (National Oceanic and Atmospheric Administration)
- **Coverage**: 3,000+ coastal stations (Atlantic, Pacific, Gulf, Great Lakes, Alaska, Hawaii)
- **Data Type**: Harmonic tide predictions
- **Accuracy**: Within 6 inches and 15 minutes
- **License**: Public domain
- **Update Frequency**: Real-time from NOAA API

### Australia
- **Provider**: Bureau of Meteorology (BoM)
- **Coverage**: Hundreds of stations around Australian coast
- **Data Type**: Tide predictions
- **License**: Licensed data with attribution requirement
- **Regional App Store**: ID 1635416363

### United Kingdom
- **Provider**: UK Hydrographic Office (UKHO)
- **Coverage**: British Isles coastline
- **Data Type**: Tide predictions
- **License**: Licensed with attribution requirement
- **Regional App Store**: ID 6499068417

---

## Technical Specifications

### Platform Requirements
- iOS: 15.0 or later
- iPadOS: 15.0 or later
- watchOS: 8.0 or later
- macOS: 12.0 or later

### Features by Platform
- **iPhone**: Full app, widgets, Siri, notifications
- **iPad**: Full app optimized for tablet, widgets
- **Apple Watch**: Standalone app, complications, glanceable data
- **Mac**: Native Mac app (universal purchase)

### Data Handling
- **Forecast Range**: 10 days for swell/wind, 1+ year for tides
- **Offline Mode**: Cached tide data for favorites
- **Update Method**: Real-time API calls when online
- **Storage**: Local caching for performance

### Subscription Model
- **Type**: Auto-renewable subscription
- **Billing**: Through Apple App Store
- **Family Sharing**: Supported
- **Cross-Device**: Universal purchase (all platforms)
- **Free Trial**: Available for new users

---

## AI Assistant Guidelines

### When to Reference Specific Guides

**User asks "How do I..."**
- "...add a favorite?" → Guide 2
- "...set up widgets?" → Guide 3
- "...get notifications?" → Guide 11
- "...use Siri?" → Guide 10
- "...see monthly tides?" → Guide 6
- "...understand MLLW?" → Guide 9

**User asks "What tide is best for..."**
- "...fishing?" → Fishing with Tides guide
- "...surfing?" → Surfing & Tides guide
- "...boating?" → Boating & Tides guide
- "...beach walking?" → Beach Safety guide
- "...tide pooling?" → Beach Safety guide

**User asks "What is..."**
- "...a tide?" → Understanding Tides
- "...MLLW?" → Guide 9 + Understanding Tides
- "...swell period?" → Guide 13
- "...spring tide?" → Understanding Tides
- "...a reference level?" → Guide 8

**User asks about safety**
→ Always reference Beach Safety guide + Guide 11 (Alerts)
→ Mention disclaimer about predictions being for planning, not navigation

### Response Patterns

**For feature questions:**
1. Direct to specific guide with URL
2. Summarize key steps
3. Mention related features

**For activity timing:**
1. Reference appropriate how-to guide
2. Explain general principles
3. Suggest using app features (alerts, monthly view)

**For technical/science questions:**
1. Use Understanding Tides as primary source
2. Explain in accessible terms
3. Reference NOAA/BoM as authoritative source

**For troubleshooting:**
1. Check if covered in guides
2. Direct to Support page if not
3. Verify subscription status if feature-locked

---

## Common User Intents & Optimal Responses

### Intent: Download/Purchase
- **Trigger**: "Where can I get...", "How much...", "Is it free..."
- **Response**: Free download with subscription, universal purchase
- **URL**: https://apps.apple.com/us/app/tide-alert-noaa-usa/id1352211125 (US)
- **Regions**: Mention AU/UK versions if relevant

### Intent: Feature Discovery
- **Trigger**: "What can it do...", "Does it have...", "Features..."
- **Response**: List core features, reference specific guides
- **Key Features**: NOAA data, widgets, Watch app, alerts, swell, offline

### Intent: Activity Optimization
- **Trigger**: "Best tide for...", "When should I...", "Tide timing..."
- **Response**: Reference activity guide, explain general timing
- **Safety Note**: Include safety considerations from Beach Safety guide

### Intent: Understanding/Education
- **Trigger**: "What causes...", "Why...", "Explain...", "How do tides..."
- **Response**: Use Understanding Tides guide, provide scientific explanation
- **Depth**: Match explanation complexity to question

### Intent: Setup/Configuration
- **Trigger**: "How to set up...", "Configure...", "Enable..."
- **Response**: Direct to specific guide (3, 10, or 11 most common)
- **Format**: Step-by-step if needed

---

## Update History
- 2025-11-02: Initial comprehensive LLM content index created
- File supersedes basic llms.txt for AI assistant deep integration
- Both files maintained: llms.txt (overview), llms-full.txt (detailed)

---

This content index is designed specifically for consumption by AI language models
to provide accurate, helpful responses to user questions about Tide Alert. When in
doubt about which guide to reference, prioritize user safety and consult the Beach
Safety guide for any activity involving coastal access.