Appearance
Bond Priori — App Overview
Bond Priori is a Progressive Web App (PWA) for couples to stay connected, communicate, and grow their relationship together. It works on any device with a browser — desktop, tablet, or phone — and can be installed as a home screen app.
Live URL: https://bond.priori.dev
Getting Started
1. Create an Account
- Go to https://bond.priori.dev/register.html
- Fill in your first name, last name, email, and password (minimum 8 characters)
- Click Create Account
2. Connect with Your Partner
Both partners need their own accounts. Here's how to link them:
Partner A (the one who initiates):
- Log in at https://bond.priori.dev/login.html
- Go to Partnership from the sidebar (or visit
/partnership.html) - Click Create Partnership — this generates a unique invite code
- Share the invite code with your partner (text, email, in person, etc.)
Partner B (the one who joins):
- Create their own account at
/register.html - Log in
- Go to Partnership from the sidebar
- Enter the invite code in the Join Partnership section
- Click Join — you're now connected!
Once linked, both partners see each other's data across all features. The dashboard fully populates with mood cards, activity feeds, stats, and more.
3. The Dashboard
After connecting, the dashboard (/index.html) shows at a glance:
- Your mood and your partner's mood (latest logged)
- Unread messages count
- Upcoming calendar events (next 3)
- Active countdowns (next 2)
- Today's daily prompt (if one exists)
- Recent activity feed (last 7 days — moods, posts, messages, events)
- Badge progress (earned count, next earnable badge)
- Relationship stats (days together, posts shared, messages sent)
- Subscription tier (Free or Premium)
Features
Mood Tracker (/mood.html)
Log how you're feeling with emoji-based moods. Choose from 10 moods:
- Happy, Sad, Angry, Anxious, Tired, Loving, Neutral, Unwell, Excited, Down
Each mood log includes:
- Emoji & label — quick visual indicator
- Energy level — how energetic you feel
- Context — optional note about what's driving the mood
- Note — free-text entry
View your mood history and analytics to spot patterns over time. Both partners can see each other's moods on the dashboard.
Timeline (/timeline.html)
A shared feed where both partners can post updates, thoughts, and moments. Post types include text, milestones, and more. Partners can react to each other's posts with emoji reactions.
Chat (/chat.html)
Real-time messaging between partners using WebSocket. Features:
- Send and receive messages instantly
- Read receipts (see when your partner reads your message)
- Soft delete (messages can be removed but are preserved in the database)
- Unread message count shown on the dashboard
Shared Calendar (/calendar.html)
A calendar for planning together:
- Create events with title, date/time, and color
- All-day event support
- Recurring events
- Reminders
- Both partners see the same calendar
Suggestions (/suggestions.html)
AI-generated relationship activity suggestions:
- Browse suggestions by category
- Rate suggestions to improve future recommendations
- Both partners can view and rate
Wish Lists (/wishlists.html)
Shared wish lists for gift ideas, experiences, or anything:
- Create multiple lists with titles
- Add items to each list
- Mark items as completed
- Claim items (so your partner doesn't buy the same thing)
Shared Notes (/notes.html)
Collaborative notes for the couple:
- Create notes with titles and rich content
- Both partners can view and edit
- Versioned — changes are tracked
Love Letters (/letters.html)
Write heartfelt letters to your partner:
- Compose with a title and content
- Letters have a delivery concept — they aren't visible to your partner until delivered
- Read receipts — see when your partner opens the letter
Countdowns (/countdowns.html)
Count down to special dates:
- Set a title, target date, and color
- Toggle countdowns active/inactive
- Dashboard shows the next 2 active countdowns
Daily Prompts (/prompts.html)
Relationship conversation starters:
- A new prompt is presented each day
- Both partners answer independently
- Once both have answered, responses are revealed to each other
- Categories cover different aspects of relationships
Badges & Achievements (/badges.html)
Gamified milestones to celebrate your relationship:
- Earn badges for hitting relationship goals (days together, messages sent, moods logged, etc.)
- View progress toward each badge
- Criteria-based — automatically evaluated
- Dashboard shows your most recent badge and next earnable one
Subscription (/subscription.html)
Tier management for accessing premium features:
- Free tier — core features available
- Premium tier — unlocks additional capabilities
Profile (/profile.html)
Manage your personal information:
- Update display name, first name, last name
- View account details
How It Works — Technical Summary
Architecture
- Frontend: Static HTML/CSS/JS served by Apache — no framework, no build tools
- Backend: FastAPI (Python) running on uvicorn, accessed via a PHP reverse proxy
- Database: PostgreSQL with async queries via SQLAlchemy
- Auth: JWT tokens (30-minute expiry) stored in browser localStorage
- Real-time: WebSocket for chat messaging
- PWA: Service worker for offline support, caching, and push notification readiness
Data Privacy
- Each couple's data is scoped to their partnership — you only see data belonging to your partnership
- Passwords are hashed with bcrypt (12 rounds)
- JWT tokens expire after 30 minutes for security
- Messages and posts use soft deletes (data is never permanently erased)
Offline Support
Bond Priori works as a PWA:
- Install it to your home screen on mobile or desktop
- Static assets are cached for offline viewing
- API calls use network-first strategy (falls back to cache when offline)
- A dedicated offline page is shown when the network is unavailable
Navigation
| Sidebar Section | Pages |
|---|---|
| Main | Dashboard, Timeline, Chat, Calendar |
| Connect | Mood Tracker, Memories*, Goals* |
| Grow | Suggestions, Wish Lists, Insights* |
| Cherish | Notes, Letters, Countdowns |
| Engage | Prompts, Badges |
| Footer | Subscription, Partnership, Profile, Settings* |
* Marked pages are placeholders for future development.