Specter

Creating Your Account

1. Open Specter and tap Create Account
2. Enter your Display Name, Username, Email, and Password (minimum 8 characters)
3. Select your Privacy Tier:

   Ghost	Stats and location hidden except for trust circles
   Stealth	Stats public, location restricted to trust circles + explicit grants
   Social	Stats public, location requires per-activity grant

4. Tap Register — you're signed in automatically

Signing In

1. Sign in with username and password, or use OAuth — Google, Apple, or Facebook
2. Your session persists until you sign out — tokens are stored securely on-device

Home & Navigation

The app has five tabs along the bottom:

Tab	What It Shows
Stats	Activity streaks, sleep insights, training load, time-of-day analysis
Training	Training plans, today's scheduled workouts
Activities	Your activity feed — the default home screen
Social	Share grants and trust circles
Profile	Account info, privacy tier, sign out, delete account

Activities

Activity Feed

The Activities tab shows your activity feed. Each card displays distance, duration, pace, and heart rate. If an activity has pending sync, you'll see an orange badge at the top with the count of unsynced activities and a button to sync manually.

Logging an Activity Manually

1. From the Activities tab, tap the small pencil button (the inner FAB)
2. Enter a Title and select the Activity Type (Run, Ride, Swim, Hike, Walk, or Other)
3. Pick Start and End date/time
4. Enter Distance (km), Duration (minutes)
5. Optionally add Elevation Gain (meters), Average Heart Rate (bpm), and Notes
6. Tap Save

Viewing Activity Details

1. Tap any activity in your feed
2. View the full stats grid: distance, duration, pace, elevation, heart rate, calories
3. See weather conditions (temperature, humidity, wind) if available
4. View pace splits — first half vs. second half comparison
5. See comparison insights and find similar routes
6. View notes and device source (phone GPS, Apple Watch, Garmin, etc.)

Route Comparison

From an activity detail, tap Compare to see a side-by-side comparison with another activity. The comparison shows a similarity score badge and stat-by-stat differences with improvement indicators.

Deleting an Activity

1. Open the activity detail
2. Tap the menu button (top right) and select Delete
3. Confirm the deletion

GPS Recording

1. From the Activities tab, tap the large GPS button (the outer FAB)
2. Select your activity type (Run, Ride, Swim, Hike, Walk, or Other)
3. Grant location permissions if prompted
4. Recording begins immediately

During Recording

The recording screen shows a live OpenStreetMap view with your route drawn as a polyline, plus a real-time stats panel:

Stat	Details
Pace / Speed	Current pace (min/km) or speed (km/h) depending on activity type
Time	Elapsed time
Distance	Total distance in km
Elevation	Elevation gain in meters

Finishing a Recording

1. Tap Pause to pause the workout
2. While paused, enter a title for the activity
3. Choose: Resume to continue, Save to finish, or Discard to delete
4. On save, the activity is stored locally with the full GPS track and queued for sync

Stats Dashboard

The Stats tab gives you an overview of your fitness trends:

Section	What It Shows
Activity Streak	Current streak (days), longest streak, activities this week
Sleep & Performance	Insights from synced health device sleep data
Time of Day	When you tend to be most active
Training Load	Chart of recent training volume
Personal Goals	Flags and milestones
Circle Aggregates	Group stats from your trust circles

Training Plans

The Training tab shows today's scheduled workouts at the top, followed by your training plans with progress bars.

Creating a Training Plan

1. From the Training tab, tap +
2. Enter a Plan Name and Goal
3. Set the Start and End dates
4. Add workouts: for each one, set a date, activity type, description, and optional targets (distance, duration, pace)
5. Tap Save

Tracking Progress

1. Tap a plan to see its detail view
2. Workouts are grouped by date with a progress bar showing completed vs. total
3. Mark workouts as completed as you go

Sharing

Creating a Share Grant

1. Go to the Social tab, which opens on the Grants view
2. Tap +
3. Select the grant type:

   Stats Only	Recipient sees workout stats, no location data
   Approximate Route	Recipient sees start/end points jittered by 500m
   Full Route	Recipient sees the complete GPS track

4. Tap Create — a share link is generated

Managing Grants

1. Given tab — grants you've created. Each shows the grant type, creation date, and expiry. Tap Revoke to terminate access. Revoked and expired grants show a red badge.
2. Received tab — activities shared with you, showing the same grant details.

Trust Circles

Trust circles let you define groups of people with specific permissions to your data — no share links needed.

Creating a Circle

1. From the Social tab, navigate to Circles
2. Tap +
3. Enter a name (e.g. "Running Crew", "Family", "Unit")
4. Tap Create

Circle Detail View

Tap a circle to open it. The detail screen has two tabs: Members and Challenges.

Adding Members

1. On the Members tab, tap +
2. Enter the member's User ID
3. Set permissions:
   • Can See Stats — on by default
   • Can See Location — off by default
4. Tap Add

The Members tab also shows a Recent Activity feed for the circle, grouped by date.

Challenges

Challenges live inside trust circles. They let circle members compete on fitness goals over a set time period.

Creating a Challenge

1. Open a trust circle and go to the Challenges tab
2. Tap +
3. Enter a Title
4. Select the Goal Type:

   Most Distance	Total distance over the challenge period
   Longest Streak	Most consecutive days with an activity
   Most Activities	Total number of activities logged

5. Set the Start and End dates
6. Tap Create

Participating

1. Challenge cards show the goal type, date range, and participant count
2. Tap Join to enter a challenge (or Leave to exit)
3. The leaderboard shows the top 5 participants with medal icons

Privacy & Profile

The Profile tab shows your avatar, display name, and username.

Changing Your Privacy Tier

1. Under Privacy Tier, select your new tier
2. Confirm the change — it applies immediately

Signing Out

1. Tap Sign Out — all tokens are deleted from the device

Deleting Your Account

1. Tap Delete Account
2. Confirm — all data is cryptographically wiped within 24 hours

Linking Your Apple Watch

1. Install Specter on your Apple Watch
2. Open Specter on the watch — tap Link Device
3. A 6-digit code appears on the watch
4. Your iPhone shows a confirmation prompt with the same code
5. Tap Confirm on the phone
6. The watch is now linked and fully independent