Tend

A plant care app for iPhone. Tracks your houseplants and garden plants and tells you when to water, feed, prune, repot, rotate, and mist them.

Requirements

• Xcode 15 or later
• iOS 17+ device or simulator
• xcodegen installed (brew install xcodegen)

Setup

1. Clone the repo

2. Generate the Xcode project

   xcodegen generate
   

   This creates Tend.xcodeproj from project.yml.

3. Add your Anthropic API key (optional — the app works fully without it)

   • Copy Tend/Resources/Secrets.example.plist to Tend/Resources/Secrets.plist
   • Replace your-anthropic-api-key-here with your real key from console.anthropic.com
   • Secrets.plist is gitignored — it will never be committed

4. Open and run

   open Tend.xcodeproj
   

   Select your device or simulator, then run (⌘R).

5. First run

   • Go to Settings to load sample data and enable notifications
   • Add your first plant via the + button on the Today or Plants tab

Adding the Tend Today widget

Home Screen

1. Long-press the Home Screen until icons jiggle.
2. Tap + (top-left on iOS 16+) and search for Tend.
3. Choose a size — Small (hero plant photo), Medium (up to 3 plant cards), or Large (list of up to 6 tasks).
4. Tap Add Widget, then tap Done.

Tapping the widget opens the Tend dashboard directly.

Lock Screen

1. Long-press the Lock Screen and tap Customize.
2. Tap the Lock Screen itself (not the Notification area).
3. Tap the widget row below the time and choose Tend Today.
4. Pick a lock screen size — Circular (due count), Rectangular (summary line), or Inline (single line).
5. Tap Done and confirm.

After setup

The widget refreshes automatically at midnight (to roll over today's tasks) and whenever Tend is foregrounded. You can force an immediate refresh by opening Tend and completing or editing any care task.

Note: The App Groups capability must be enabled for both targets in Xcode (matching identifier group.com.martha.Tend) for the widget to read the same data as the app. See the Widget section in CLAUDE.md for details.

API key note

The "Identify care needs" feature sends the plant species name to the Anthropic API and receives suggested care intervals. Without a key, tapping the button shows a clear error and the app falls back to the bundled care database. All other features work offline.