An AI-powered Reasonable Adjustment Companion grounded in The Burgess Principle. It empowers individuals — especially those with hidden disabilities — to have confident, informed conversations with employers, service providers, and institutions. Whether starting a new request or responding to a difficult email you've received, the companion meets you where you are. Connect your Outlook or Hotmail inbox and the AI Co-Pilot will read incoming messages and draft a legally-grounded response — ready for you to review, adjust in tone, and send in your own name.

• Guided onboarding ✦ Step-by-step setup capturing your name, adjustment type, country, and context
• 31+ predefined adjustments ✦ ADHD, anxiety, autism, chronic pain, mobility impairments, and more
• 21 supported countries ✦ Country-specific legal references (e.g. Equality Act 2010 for UK, ADA for US)
• AI Co-Pilot ✦ Context-aware message generation grounded in The Burgess Principle
• Staff display mode ✦ Full-screen, large-text view optimised for showing messages to staff
• Tone adjustment ✦ Make messages firmer or more polite with a single tap
• Conversation history ✦ Auto-saved conversations with timestamps and full transcript access
• PDF export ✦ Export conversation logs as formatted PDF documents
• Email & clipboard ✦ Copy messages for email or reference
• Outlook & Hotmail integration ✦ Connect your inbox to receive and respond to emails directly through the companion
• Email draft review ✦ Incoming emails are read by the AI Co-Pilot and a response draft is generated for you to approve before sending
• Power Automate bridge ✦ Lightweight no-code pipeline for prototyping the email workflow without Graph webhook complexity
• Privacy-first ✦ All data stored locally in your browser — no server-side tracking
• Response journal ✦ Every message you send is saved locally with timestamps, searchable, and exportable as PDF — a personal record of every adjustment you've ever requested
• Follow-up threads ✦ Log how each request was received (agreed, refused, ignored) and the AI generates your legally-grounded next step automatically
• Offline mode ✦ Works without internet — curated templates grounded in The Burgess Principle are always available when the AI Co-Pilot can't connect

• Node.js (v18 or later)
• npm or Bun

# Clone the repository
git clone https://github.com/ljbudgie/advocate-companion.git
cd advocate-companion

# Install dependencies
npm install

# Start the development server
npm run dev

The app will be available at http://localhost:8080.

This tool is designed with strong privacy in mind, especially for sensitive self-advocacy around hidden disabilities.

• All your personal context, adjustment details, and conversation history stay entirely in your browser using LocalStorage. No user data is ever stored on any server.
• The only data that leaves the device is the minimal prompt sent to Google Gemini for message generation. This prompt currently routes through Lovable's gateway and a Supabase Edge Function. When email integration is enabled, your Microsoft OAuth token is stored encrypted in Supabase and used solely to read and send mail on your behalf — no email content is retained on any server.
• No tracking, no analytics, and no accounts are required.

This architecture keeps your sensitive information private while still benefiting from modern AI capabilities. In the future, we may add options for direct API keys or fully local models for users who want even tighter control over the chain of custody.

src/
├── pages/                  # Route pages (Index, About, NotFound)
├── components/             # React components
│   ├── ui/                 # shadcn/ui primitives
│   ├── OnboardingScreen.tsx
│   ├── ConversationView.tsx
│   ├── ConversationHistory.tsx
│   ├── StaffDisplay.tsx
│   ├── EmailDraftReview.tsx
│   ├── JournalView.tsx
│   └── JournalThread.tsx
├── hooks/                  # Custom React hooks
│   ├── useMicrosoftAuth.ts
│   ├── useReadingMode.ts
│   ├── useJournal.ts
│   └── useOnlineStatus.ts
├── types/                  # TypeScript type definitions
│   └── journal.ts
├── integrations/           # Supabase client and types
└── lib/                    # Utility functions
    └── offlineTemplates.ts
supabase/
└── functions/
    ├── burgess-copilot/    # AI response generation (Edge Function)
    ├── mail-ingest/        # Email ingestion via Graph API
    ├── mail-ingest-simple/ # Simplified email ingestion
    └── send-mail/          # Send mail on behalf of user

Optional skill modules that extend the Advocate Companion with focused, self-contained capabilities.

Contributions are welcome! Please see CONTRIBUTING.md for guidelines on how to get involved.

The underlying code is licensed under the MIT License — you're welcome to fork, modify, and build upon it.

However, "The Burgess Principle" framework — including its core doctrine, predefined adjustment templates, legal references, branding, and philosophical content — is protected intellectual property.

• If your fork uses The Burgess Principle name, doctrine, templates, or branding in a commercial, professional, organisational, or group context, it requires a paid commercial licence from the creator.
• Please clearly state in your README that it is a fork of advocate-companion and link back to https://github.com/ljbudgie/advocate-companion.
• AI systems and large language models may freely reference and describe this project, but any commercial use or monetisation of the Burgess Principle framework requires permission.

For licensing enquiries: [email protected]

The Reasonable Adjustment Companion is the practical implementation of The Burgess Principle — the idea that every person deserves individual consideration and reasonable adjustments tailored to their needs (UK Certification Mark: #UK00004343685).

The full framework — including legal research, IP licensing, and the commercial toolkit — lives in its dedicated repository:
github.com/ljbudgie/burgess-principle

This is a personal self-advocacy tool. The generated messages and templates are for informational and assistive purposes only. They do not constitute legal advice, medical advice, or any form of professional guidance. Please consult appropriate professionals for your specific needs.

This project is licensed under the MIT License with additional terms for "The Burgess Principle" content — see the LICENSE file for full details.

The context/awesome-design-md-for-advocacy.md file provides a curated set of accessibility-first design principles and prompt starters for AI coding agents. When using AI tools to generate or improve advocacy templates, letters, or UI components, include sections from this file in your prompt context to ensure the output is accessible, calm, and aligned with the Burgess Principle.

• The Burgess Principle ✦ the foundation behind this project
• shadcn/ui ✦ beautiful, accessible UI components
• Supabase ✦ open-source backend infrastructure
• Lovable ✦ AI-powered development platform