🌈 MBTQ.dev | Compliance and Workforce Modules

A modular, production-ready reusable compliance and workflow mddules originally built to support deaf entrepreneurs, job seekers, developers, and creatives.

Generative AI Platform for Building with Supabase & Modern Frameworks

VR Agency • Deaf Community • LGBTQ+ Agency Compliant

🚀 Built by Community, Powered by AI

---

🌟 Overview

The MBTQ.dev has new features = Magician Modules is a reusable compliance and workflow system originally built to support deaf entrepreneurs, job seekers, developers, and creatives. It provides battle-tested, modular components that any organization can integrate to handle:

• Vocational Rehabilitation (VR) Compliance - Complete 34 CFR Part 361 tracking and reporting
• Workforce Development - WIOA-aligned program management and outcome tracking
• Accessibility Standards - WCAG 2.1 Level AA compliance tooling and auditing
• LGBTQ+ Agency Compliance - Inclusive service tracking for LGBTQ+ organizations
• Security Validation - Authentication, authorization, and audit logging
• Workflow Automation - GitHub Apps, bots, and AI agents for task automation
• Generative AI Integration - GPT-4, Claude, Gemini integration examples
• Database Schema - Production-ready schemas with Drizzle ORM and Zod validation

---

📢 Platform Focus

Core Focus:

• 🤖 Generative AI Development Platform - Build full-stack applications with modern AI tools
• 📋 VR Agency Compliance - 34 CFR Part 361 tracking and reporting built-in
• 🦻 Deaf Community First - ASL-friendly, accessibility-first design
• 🏳️‍🌈 LGBTQ+ Agency Friendly - Inclusive compliance and service tracking

---

✨ What MBTQ.dev Offers Today

Feature	Description
🤖 Generative AI Integration	Learn how to integrate AI models (GPT-4, Claude, Gemini) into your full-stack applications with best practices and examples.
🔌 Supabase Backend	Complete guides for connecting your frontend to Supabase - authentication, real-time database, storage, and edge functions.
⚡ Modern Frameworks	Examples and starter kits using Next.js, React, and other modern frameworks for rapid development.
🦻 Deaf-First Accessibility	WCAG-compliant components, screen reader optimization, and ASL-friendly design patterns built into every template.
📋 VR Compliance	Complete 34 CFR Part 361 tracking, enrollment management, and outcome reporting for VR agencies.
🏳️‍🌈 LGBTQ+ Agency Support	Inclusive service tracking, compliance features, and community-friendly design patterns.
📚 API Discovery	Learn how to find, integrate, and work with third-party APIs to enhance your applications.
🎨 Full-Stack Templates	Production-ready templates with authentication, database, and API integrations already configured.

---

🎯 Specialized Platforms → Magician Ecosystem

Looking for specialized features? These are available on dedicated platforms powered by 360 Magicians AI agents:

Platform	Focus	Features
💼 BUSINESS MAGICIAN	Entrepreneurship	✓ Idea Validation & Market Research ✓ Business Plan Generation ✓ Growth Strategy Planning ✓ Managed Services for Entrepreneurs
🎨 CREATIVE MAGICIAN	Creative Features	✓ ASL Content Creation ✓ Portfolio Building ✓ Brand Development
🎯 JOB MAGICIAN	Career/Employment	✓ Job Matching & Search ✓ Resume Building ✓ Interview Preparation
💻 DEVELOPER MAGICIAN	SaaS/Development	✓ Project Scaffolding ✓ Code Review ✓ Deployment Guidance

---

🤟 Why Use MBTQ.dev?

✅ Modular Architecture - Use individual components or the full system
✅ Production Ready - Battle-tested with real VR and workforce programs
✅ Compliance Built-In - Federal regulations baked into the schema and validation
✅ Deaf-First Design - ASL-friendly with WCAG 2.1 AA compliance
✅ LGBTQ+ Friendly - Inclusive design for LGBTQ+ agencies and services
✅ AI-First - Generative AI integrated throughout
✅ Type-Safe - Full TypeScript with Zod runtime validation
✅ Well Documented - Comprehensive guides for integration and deployment

Use Cases

• VR Agencies: Track enrollments, services, milestones, and outcomes with 34 CFR Part 361 compliance
• LGBTQ+ Agencies: Manage inclusive services with compliant tracking and reporting
• Deaf Community Services: Build accessible applications with ASL-friendly design
• Workforce Programs: Manage WIOA compliance and performance metrics
• Developers: Build full-stack applications with modern AI-powered tools
• Startups: Get production-ready templates and scaffolding
• Government Contractors: Meet accessibility and compliance requirements
• SaaS Platforms: Integrate AI, Supabase, and compliance features into your product
• Educational Institutions: Track student services and outcomes
• Healthcare Systems: Manage rehabilitation and employment services

🚀 Quick Start with Supabase

# 1. Install Supabase Client
npm install @supabase/supabase-js

# 2. Initialize in your app

import { createClient } from '@supabase/supabase-js'

const supabase = createClient(
  'YOUR_SUPABASE_URL',
  'YOUR_SUPABASE_ANON_KEY'
)

// 3. Start building!

// Authentication
await supabase.auth.signUp({ email, password })

// Database queries
const { data } = await supabase.from('users').select('*')

// Real-time subscriptions
supabase.channel('public:posts')
  .on('postgres_changes', { event: '*', schema: 'public', table: 'posts' }, 
    payload => console.log(payload)
  )
  .subscribe()

---

🤖 GitHub Apps, Bots & Agents

MBTQ.dev provides streamlined repository controls through:

Automated Workflow Controls

Component	Purpose
🔧 GitHub Apps	Automated code review, deployment triggers, and compliance checks
🤖 Bots	Issue triage, PR labeling, and automated documentation updates
🎯 AI Agents	Intelligent code generation, accessibility auditing, and testing

GitHub Actions Workflows

# .github/workflows/mbtq-ci.yml
name: MBTQ.dev CI
on: [push, pull_request]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: MBTQ-dev/mbtq-action@v1
        with:
          check-type: 'accessibility'
          ai-review: true

---

🔌 Integration Options

MBTQ.dev can be integrated into your project in multiple ways:

1. Supabase Backend Integration

Connect your frontend to Supabase with our pre-built configurations:

// Example: Full-stack integration
import { createClient } from '@supabase/supabase-js'
const supabase = createClient(process.env.SUPABASE_URL!, process.env.SUPABASE_KEY!)

// Authentication, database, storage - all ready to go
const { data: user } = await supabase.auth.getUser()

2. AI Integration Templates

Use our templates for GPT-4, Claude, and Gemini integration:

import { OpenAI } from 'openai'
import Anthropic from '@anthropic-ai/sdk'

// Pre-configured AI clients with best practices
const openai = new OpenAI()
const anthropic = new Anthropic()

3. Workflow Modules

Use our GitHub Actions workflows for automated development:

# In your .github/workflows/
- uses: MBTQ-dev/mbtq-action@v1
  with:
    check-type: 'full-stack-review'
    accessibility-audit: true

4. Full Platform Deployment

Deploy the entire platform and integrate via webhooks:

// Subscribe to platform events
POST /api/webhooks/register
{ "url": "your-app.com/webhook", "events": ["build.completed", "review.ready"] }

See the Deployment Guide for complete integration instructions.

🤖 360 Magicians - AI Agent Services

Core Development Agents

Agent	Focus	Capabilities
🚪 Gatekeeper Magician	Security	Identity verification, access control, DeafAuth integration, security monitoring
⭐ Reputation Tracker Magician	Trust	Fibonrose reputation scoring, badge issuance, contribution tracking, community trust
🔄 Workflow Automator Magician	Automation	Task execution, workflow management, system health, integration coordination
💬 Community Concierge Magician	Support	FAQ with ASL, resource discovery, mentor matching, opportunity surfacing

Specialized Platform Agents

Agent	Platform	Capabilities
💼 Business Magician	BUSINESS MAGICIAN	Business idea generation, plan creation, formation guidance, SBA resources, VR self-employment pathway
💻 Developer Magician	MBTQ.dev	Project scaffolding, code review, accessibility auditing, deployment guidance
🎯 Job Magician	JOB MAGICIAN	Job matching, resume building, interview prep, accommodation guidance, VR job placement
🎨 Creative Magician	CREATIVE MAGICIAN	ASL content creation, video production, brand development, portfolio building

---

🎯 Deno + Supabase Integration

The platform supports dual runtime environments:

• Node.js Backend: Express server for production workloads
• Deno Application: Modern, secure runtime with Supabase integration

Modular Components

Component	Purpose
🔐 DeafAuth	Supabase-powered authentication with OAuth support
⚡ PinkSync	Real-time communication and accessibility optimization
⭐ FibonRose	Fibonacci-based reputation and trust scoring
✅ PinkFlow	Automated testing and workflow validation

👉 Read the complete Deno & Supabase Integration Guide

---

🚀 Key Features

Vocational Rehabilitation (VR) Compliance

• ✅ VR enrollment and tracking - Full case management
• ✅ IPE (Individualized Plan for Employment) support
• ✅ Service authorization and documentation
• ✅ Milestone tracking and monitoring
• ✅ 90-day employment outcome tracking
• ✅ Self-employment pathway guidance
• ✅ Compliance with 34 CFR Part 361

LGBTQ+ Agency Compliance

• ✅ Inclusive service tracking - LGBTQ+ friendly intake and case management
• ✅ Community resource integration - LGBTQ+ organization partnerships
• ✅ Safe space compliance - Privacy-first design patterns
• ✅ Pronoun and identity support - Respectful data handling
• ✅ Anti-discrimination tracking - Compliance monitoring

Workforce Solutions

• ✅ WIOA program integration
• ✅ Employment outcome tracking
• ✅ Performance metrics and reporting
• ✅ Compliance checks and auditing
• ✅ Retention milestone monitoring

Generative AI Integration

• ✅ GPT-4, Claude, Gemini - Pre-configured AI clients
• ✅ Best practices - Prompt engineering and response handling
• ✅ Cost optimization - Efficient token usage patterns
• ✅ Error handling - Robust fallback mechanisms

Modern Framework Support

• ✅ Next.js templates - Server-side rendering ready
• ✅ React components - Accessible UI components
• ✅ TypeScript first - Full type safety
• ✅ Tailwind CSS - Utility-first styling

Accessibility Features

• ✅ ASL video content throughout
• ✅ WCAG 2.1 Level AA compliance
• ✅ Full keyboard navigation
• ✅ Screen reader optimization
• ✅ Visual notification system
• ✅ Deaf-first design principles
• ✅ Queer-friendly design patterns

Technical Excellence

• ✅ Comprehensive Zod validation - Type-safe operations
• ✅ Semantic database schema - Drizzle ORM
• ✅ Inter-Agent coordination - Magician communication
• ✅ Audit trail logging - Full compliance tracking
• ✅ DeafAuth + JWT - Secure authentication
• ✅ Rate limiting and security

🔧 Technologies

• Frontend: React + TypeScript, Shadcn/UI components
• Backend: Express.js + TypeScript
• Database: PostgreSQL with Drizzle ORM
• Validation: Zod schemas throughout
• Authentication: DeafAuth + JWT tokens
• Storage: Google Cloud Storage
• Backend-as-a-Service: Supabase
• Deployment: Vercel
• AI/ML: OpenAI GPT-4, Anthropic Claude, Google Gemini
• Real-time: Socket.io, HTMX

📋 Requirements

• Node.js 20+
• Supabase account (or PostgreSQL database with Docker)
• OpenAI/Anthropic API key (for AI features)
• Vercel account (for deployment, optional)

🏁 Getting Started

Quick Start

1. Clone the repository:

   git clone https://github.com/MBTQ-dev/MBTQ.dev.git
   cd MBTQ.dev

2. Install dependencies:

   npm install --legacy-peer-deps

3. Set up environment variables:

   cp .env.example .env
   # Edit .env with your Supabase and AI API keys

4. Set up the database:

   npm run db:push

5. Start the development server:

   npm run dev

Deno + Fresh Application (Optional)

The platform includes an optional Deno-based Fresh framework application in the /deno-app directory that can run alongside the main Node.js application.

To run the Deno application:

1. Install Deno (if not already installed):

   curl -fsSL https://deno.land/x/install/install.sh | sh

2. Set the database environment variable:

   export SUPABASE_DB_URL="postgres://user:password@host:port/database"

3. Start the Deno Fresh app:

   cd deno-app
   deno task dev

The Deno application will be available at http://localhost:8000 and provides:

• Fresh framework for server-side rendering
• Example API routes (/api/trust)
• Interactive island components
• Supabase connectivity

See deno-app/README.md for detailed documentation.

📚 Documentation

Integration & Deployment

• Deployment Guide - Production deployment instructions and options
• Accessibility Statement - WCAG 2.1 AA compliance details
• Security Policy - Security practices and vulnerability reporting
• Deno + Supabase Guide - Complete Deno integration guide

Technical Documentation

• AI Agent Services - Detailed Magician capabilities
• Implementation Summary - Technical implementation details
• Platform Integration - Integration guide
• API Routes - Complete API documentation

Interactive Demo

• GitHub Pages - Live platform demo and integration examples

---

🗄️ Database Schema

The platform includes comprehensive database schemas for:

Core Tables

Table	Purpose
users	User accounts and profiles
fibonrose_scores	Reputation scores
fibonrose_activities	Point change log
fibonrose_badges	Earned badges
magician_actions	Audit trail
workflow_recipes	Automation workflows

VR Compliance Tables

Table	Purpose
vr_enrollment	VR program enrollment tracking
vr_service_records	Service documentation
vr_milestones	Progress and milestone tracking
employment_outcomes	Job placement outcomes

Workforce Tables

Table	Purpose
workforce_program_enrollment	Program tracking
workforce_compliance_checks	Compliance auditing
compliance_audit_trail	Complete audit log

See schema.ts for complete definitions.

---

🎯 API Endpoints

AI Agent Services

All AI Agents follow a standardized API pattern:

GET  /api/magicians                    - List all AI Agents
GET  /api/magicians/:id                - Get Agent info
POST /api/magicians/:id/execute        - Execute Agent action

VR Compliance Endpoints

POST /api/vr/enrollment               - Create VR enrollment
GET  /api/vr/services/:enrollmentId   - Get services for enrollment
POST /api/workforce/outcomes          - Record employment outcome

Specific Agent Endpoints

Business Magician

• POST /api/magicians/business_magician/execute with actions:
  • generate_business_idea
  • create_business_plan
  • guide_business_formation
  • find_sba_resources
  • vr_self_employment_pathway

Developer Magician

• POST /api/magicians/developer_magician/execute with actions:
  • generate_project
  • review_code
  • accessibility_audit
  • deployment_guide

Job Magician

• POST /api/magicians/job_magician/execute with actions:
  • match_jobs
  • build_resume
  • prepare_interview
  • vr_job_placement

Creative Magician

• POST /api/magicians/creative_magician/execute with actions:
  • create_asl_content
  • plan_creative_project
  • build_portfolio

See full API documentation in the Agent Services README.

---

📊 Compliance & Reporting

The platform maintains compliance with:

Standard	Description
34 CFR Part 361	VR Services regulations
Rehabilitation Act of 1973	Disability rights in federal programs
WIOA	Workforce Innovation and Opportunity Act
ADA	Americans with Disabilities Act
WCAG 2.1 Level AA	Web accessibility standards
LGBTQ+ Best Practices	Inclusive service delivery standards

Compliance reports can be generated through the platform or via GitHub Actions workflows.

---

🔒 Security & Privacy

Feature	Description
Authentication	DeafAuth service with JWT tokens and Supabase Auth
Rate Limiting	5 attempts per 15 minutes for auth
Data Encryption	At rest and in transit
Audit Logging	All actions logged for compliance
Privacy	GDPR/CCPA aligned, minimal data collection
Security	Regular vulnerability scans
LGBTQ+ Privacy	Safe space data handling, pronoun respect

---

🦻 Accessibility

The platform is built with accessibility-first design:

• ASL Video Content: Available throughout the platform
• Visual Notifications: No audio-only alerts
• Keyboard Navigation: Full keyboard accessibility
• Screen Readers: Optimized for assistive technology
• Color Contrast: WCAG 2.1 AA compliant
• Captions: All video content captioned
• Clear Communication: Plain language, visual hierarchy
• LGBTQ+ Inclusive: Queer-friendly design patterns and language

---

🔄 Workflows & Automation

The platform includes automated workflows powered by GitHub Apps, Bots, and AI Agents:

Development Workflows

Workflow	Purpose
CI/CD Pipeline	Automated testing, building, and deployment
Code Review	AI-powered code review and accessibility auditing
Documentation	Auto-generated API docs and changelog
Security Scanning	Automated vulnerability detection

User Experience Workflows

Workflow	Purpose
Onboarding	Welcome message with ASL video, profile setup
Project Scaffolding	AI-assisted project generation
Accessibility Audit	Automated WCAG compliance checking

---

🧪 Testing

# Run tests
npm test

# Run type checking
npm run typecheck

# Run linting
npm run lint

---

📦 Deployment

Vercel Deployment

# Install Vercel CLI
npm install -g vercel

# Deploy
vercel deploy --prod

Environment Variables

Required environment variables:

# Supabase
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_ANON_KEY=your-anon-key
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key

# AI Services
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...

# Authentication
JWT_SECRET=...

# Environment
NODE_ENV=production

---

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Development Workflow

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Ensure all tests pass
6. Submit a pull request

---

🆘 Support

Channel	Description
GitHub Issues	Report bugs and feature requests
Discord	Community support (ASL-friendly)
Documentation	Comprehensive guides and tutorials
Troubleshooting	See REMOVING_CLOUD_RUN_STATUS_CHECK.md for resolving stuck GitHub status checks

---

📝 License

MIT License

---

👥 Team & Acknowledgments

• 360 Magicians Team
• MBTQ.dev Platform Contributors
• Deaf Community Advisors
• LGBTQ+ Community Contributors
• Open Source Contributors

---

🗺️ Roadmap

Completed ✅

• 8 AI Agent services implemented
• Supabase integration
• Generative AI integration (GPT-4, Claude, Gemini)
• Zod validation throughout
• Comprehensive database schema
• Accessibility-first design
• LGBTQ+ friendly badges and design

In Progress 🚧

• Additional AI Agents (Content Curator, Safety Monitor, etc.)
• Mobile applications
• Advanced AI/ML features
• Real-time collaboration
• Enhanced analytics

Planned 📋

• Multi-language support (beyond ASL/English)
• More framework templates (Vue, Svelte, etc.)
• AI-powered accessibility recommendations
• Enhanced Supabase Edge Functions examples

🌐 Ecosystem

This platform is part of the MBTQ.dev ecosystem:

Platform	Focus
MBTQ.dev	AI-Powered Full-Stack Development Platform
Business Magician	Entrepreneurship and Business Services
360 Magicians	AI Agent Framework

---

🌈 MBTQ.dev © 2025 | Community. Culture. Power. 💜

Open Source • Accessibility First • AI-Powered • LGBTQ+ Friendly

For questions, feedback, or support, please open an issue or contact the team.

---

🐳 Docker Development

We provide a Docker Compose configuration for easy local development:

docker-compose up -d

Visit http://localhost:8080 to see the application.

---

📂 Project Structure

├── client/                  # Frontend React application
│   ├── src/
│   │   ├── components/      # UI components
│   │   ├── hooks/           # Custom React hooks
│   │   ├── lib/             # Utilities and API clients
│   │   ├── pages/           # Page components
├── server/                  # Backend Express application
│   ├── routes/              # API routes (modular route handlers)
│   ├── services/            # Business logic and external integrations
│   │   ├── notionService.ts         # Notion API integration
│   │   ├── northwestAgentService.ts # Business formation services
│   │   ├── magicians/               # 360 Magicians AI agents
│   ├── middleware/          # Express middleware
│   ├── index.ts             # Main server entry point (lazy-loaded routes)
│   ├── routes.ts            # Central route registration
├── shared/                  # Shared code between client and server
│   ├── schema.ts            # Database schema definitions (Drizzle ORM)
├── scripts/                 # Utility scripts
├── archived_legacy_files/   # Archived legacy standalone files (not in repo)

🏗️ Architecture

Current API Architecture

The platform uses a unified Express.js API server with modular routes:

• Main Server: server/index.ts - Express server with lazy-loaded routes for memory efficiency
• Route Registration: server/routes.ts - Central registration of all API routes
• Modular Routes: server/routes/*.ts - Individual route handlers for:
  • Business formation (businessFormationRoutes.ts)
  • Ecosystem services (ecosystemRoutes.ts)
  • AI/ML operations (ai.ts, anthropic.ts, openai-test.ts)
  • 360 Magicians (magiciansRoutes.ts)
  • Storage and file management (storage.ts)
  • And more...

Services Layer

Business logic is organized in server/services/:

• notionService.ts: Notion API integration for knowledge management
• northwestAgentService.ts: Business entity formation through Northwest Registered Agent
• deafAuthService.ts: Authentication for deaf-first platform
• fibonroseService.ts: Reputation scoring system
• magicians/: 360 Magicians AI agents (GatekeeperMagician, ReputationTrackerMagician, etc.)

Legacy Files Note

Legacy standalone API files have been archived to archived_legacy_files/ (excluded from git). See ARCHIVED_FILES.md for details on migrated functionality.

🔄 Database Management

We use Drizzle ORM for database operations. Some useful commands:

# Push schema changes to database
npm run db:push

# Generate migration files
npm run db:generate

# Open Drizzle Studio (database UI)
npm run db:studio

📦 Deployment

The application is configured for deployment on Vercel:

node scripts/vercel-deploy.js

🤝 Contributing

Please see CONTRIBUTING.md for guidelines on contributing to this project.

📄 License

MIT License

👥 Team

• 360 Magician Team