A comprehensive platform built with deaf-first foundation, providing accessible dao channel service and support, AI-powered assistance, and decentralized governance.
This repository contains OpenAPI specifications for all five core services of the MBTQ.dev:
Secure authentication system designed with deaf-first principles.
- Location:
services/deafauth/ - Base URL:
https://api.mbtq.dev/authauth.mbtq.dev - Documentation: DeafAUTH README
- OpenAPI Spec: openapi.yaml
Real-time accessibility features and synchronization.
- Location:
services/pinksync/ - Base URL:
https://api.mbtq.dev/syncsync.mbtq.dev - Documentation: PinkSync README
- OpenAPI Spec: openapi.yaml
Decentralized trust and verification layer.
- Location:
services/fibonrose/ - Base URL:
https://api.mbtq.dev/trusttrust.mbtq.dev - Documentation: Fibonrose README
- OpenAPI Spec: openapi.yaml
- Location:
services/magicians/ - Base URL:
https://api.mbtq.dev/magiciansmagicians.mbtq.dev - Documentation: 360Magicians README
- OpenAPI Spec: openapi.yaml
Decentralized governance and community management.
- Location:
services/dao/ - Base URL:
https://api.mbtq.dev/dao - Documentation: DAO README
- OpenAPI Spec: openapi.yaml
β All endpoints documented with OpenAPI 3.1
β Standardized responses across all services
β Shared DeafAUTH paseto security scheme
β Tags, components, pagination, error schemas
β Cloudflare-friendly JSON-only style
β Automated API testing with Jest
β SDK generation (TypeScript + Python)
β Interactive HTML documentation
β Fetch API examples for browsers
β Architecture documentation
β Production-ready specifications
- Architecture Documentation - System architecture, service relationships, and data flows
- Fetch API Examples - Browser-compatible API examples
- SDK Guide - TypeScript & Python SDK generation
- Interactive HTML Docs - Interactive API documentation (run
npm run docs:serveto view) - Quick Start Guide - Get up and running quickly
npm run generate:docs # Generate interactive HTML docs
npm run docs:serve # Serve docs at http://localhost:3000All MBTQ Universe services use DeafAUTH for authentication. Include the Bearer token in the Authorization header:
Authorization: Bearer <your_token>- Register a new user:
curl -X POST https://api.mbtq.dev/auth/register \
-H "Content-Type: application/json" \
-d '{"email": "user@example.com", "password": "secure_password"}'- Login to get tokens:
curl -X POST https://api.mbtq.dev/auth/login \
-H "Content-Type: application/json" \
-d '{"email": "user@example.com", "password": "secure_password"}'- Use the access token for API calls:
curl -X GET https://api.mbtq.dev/sync/status \
-H "Authorization: Bearer <your_access_token>"Note: The endpoints below show full paths including the service prefix (e.g., /auth/, /sync/). In the OpenAPI specifications, these are defined as relative paths (e.g., /register, /status) with the base URL specified in the servers section.
POST /auth/register- User registrationPOST /auth/login- User authenticationGET /auth/verify- Token verificationPOST /auth/refresh- Token refresh
GET /sync/status- Check synchronization statusPOST /sync/preferences- Update accessibility preferencesGET /sync/features- List available accessibility features
POST /trust/blockchain/verify- Verify blockchain transactionGET /trust//trust-score- Get trust scorePOST /trust/blockchain/record- Record new transaction
Comprehensive AI agent platform with 60+ endpoints including:
- Agent management (CRUD operations)
- Task execution and workflow orchestration
- Memory and context management
- File ingestion and RAG search
- Tool registration and management
- Scheduling and webhooks
- Analytics and cost tracking
See 360Magicians README for complete endpoint list.
GET /dao/proposals- List governance proposalsPOST /dao/vote- Submit voteGET /dao/members- List DAO members
Copy .env.example to .env and configure your environment variables:
cp .env.example .envSee .env.example for all required configuration options.
Google Cloud Integration:
- Google Cloud Vision API for visual accessibility features
- Google Speech-to-Text for real-time captioning
- Google Translate API for multi-language support
- PinkSync API acts as an API broker network for partners' APIs that enhance deaf accessibility
AI SDK Integration:
The platform uses multiple AI models for comprehensive coverage:
- OpenAI: GPT-4, GPT-4 Turbo for natural language processing
- Anthropic: Claude 3 for advanced reasoning
- Google: Gemini Pro for multimodal tasks
- TensorFlow.js: Client-side AI processing
- Hugging Face Transformers: Specialized accessibility models
This platform integrates with several related repositories:
- pinkycollie/pinksync - Fastify-based accessibility engine
- pinkycollie/deafauth-ecosystem - Authentication ecosystem
- pinkycollie/fibonrose - Blockchain trust layer
- pinkycollie/pinkflow - Hub pipeline integrator
Run comprehensive API tests for all services:
# Install dependencies
npm install
# Run all tests
npm test
# Run tests with coverage
npm run test:coverage
# Run specific service tests
npm test -- tests/deafauth
npm test -- tests/pinksync
npm test -- tests/magiciansSee tests/README.md for detailed testing documentation.
Validate all OpenAPI specifications:
# Validate specs
npm run validate:openapiAll specifications are validated and ready for:
- Documentation generation
- SDK generation (TypeScript, Python, Go, etc.)
- API gateway configuration
- Testing and mocking
Generate client SDKs from OpenAPI specifications:
# Generate TypeScript SDK
npm run generate:sdk:typescript
# Generate Python SDK
npm run generate:sdk:python
# Generate all SDKs
npm run generate:sdkGenerated SDKs will be in the sdks/ directory. See SDK.md for detailed documentation and usage examples.
const deafAuthMiddleware = async (req, res, next) => {
const token = req.headers.authorization?.split(' ')[1];
if (!token) {
return res.status(401).json({ error: 'No token provided' });
}
try {
const decoded = await verifyDeafAuthToken(token);
req.user = decoded;
next();
} catch (error) {
return res.status(403).json({ error: 'Invalid token' });
}
};
module.exports = deafAuthMiddleware;const pinkSyncMiddleware = async (req, res, next) => {
const userId = req.user?.id;
if (userId) {
const preferences = await getPinkSyncPreferences(userId);
req.accessibilityPrefs = preferences;
}
next();
};
module.exports = pinkSyncMiddleware;# Clone the repository
git clone https://github.com/pinkycollie/DEAF-FIRST-PLATFORM.git
cd DEAF-FIRST-PLATFORM
# Install dependencies
npm installnpm run validate:openapi# Run all tests
npm test
# Run with coverage
npm run test:coverage# Generate TypeScript SDK
npm run generate:sdk:typescript
# Generate Python SDK
npm run generate:sdk:pythonSee SDK.md for usage examples with TypeScript and Python.
Generate interactive API documentation:
# TypeScript SDK
openapi-generator-cli generate \
-i services/deafauth/openapi/openapi.yaml \
-g typescript-axios \
-o sdks/typescript/deafauth
# Python SDK
openapi-generator-cli generate \
-i services/deafauth/openapi/openapi.yaml \
-g python \
-o sdks/python/deafauthEach service can be deployed as a Cloudflare Worker for edge computing benefits.
Use Redoc, Swagger UI, or other documentation tools to generate interactive API documentation.
Implement automated testing, validation, and deployment for all services.
- Complete Infrastructure Overview
- Individual service README files in each service directory
- OpenAPI specifications in
services/*/openapi/openapi.yaml
Contributions are welcome! Please ensure all changes maintain accessibility standards and deaf-first principles.
See LICENSE file for details.
Built with deaf-first principles and a commitment to accessibility for all.
A deaf-first SaaS ecosystem with AI-powered workflows and comprehensive accessibility features.
π View Live Demo on GitHub Pages
The DEAF-FIRST Platform is a monorepo containing multiple services designed with accessibility as the primary focus. It includes authentication, real-time synchronization, AI workflows, and specialized accessibility nodes.
The platform features a modern, cutting-edge showcase interface that demonstrates all services and capabilities. See GITHUB-PAGES-SETUP.md for deployment details.
- βΏ Accessibility First: WCAG 2.1 AAA compliant design throughout
- π Secure Authentication: JWT-based auth with DeafAUTH service
- π Real-time Sync: WebSocket-based synchronization with PinkSync
- π AI-Powered: OpenAI integration for intelligent workflows
- ποΈ Microservices Architecture: Independent, scalable services
- π CI/CD Pipeline: Automated testing, security scans, and deployment
- π³ Docker Ready: Full containerization support
- βοΈ Infrastructure as Code: Terraform templates included
- Architecture - Detailed system architecture and design
- Contributing Guide - How to contribute to this project
- Quick Start - Get up and running quickly
- GitHub Pages Setup - Deploy the showcase site
- Webhook API - Webhook system documentation
- MCP Servers - Model Context Protocol integration
- Security - Security policies and reporting
This is a monorepo managed with npm workspaces containing:
- frontend: React-based accessible user interface
- backend: Express API server
- services/deafauth: DeafAUTH authentication service with MCP server support
- services/pinksync: Real-time synchronization service
- services/fibonrose: Mathematical optimization engine
- services/accessibility-nodes: Modular accessibility features
- ai: AI services for deaf-first workflows
- Node.js >= 20.0.0
- npm >= 10.0.0
- PostgreSQL (for backend and deafauth)
- Redis (for pinksync)
- Clone the repository:
git clone https://github.com/pinkycollie/Deaf-First-Platform.git
cd Deaf-First-Platform- Install dependencies:
npm install- Set up environment variables:
cp .env.example .env
# Edit .env with your configuration- Run all services in development mode:
npm run devnpm run devnpm run dev:frontend # Frontend only
npm run dev:backend # Backend only
npm run dev:deafauth # DeafAUTH only
npm run dev:pinksync # PinkSync only
npm run dev:fibonrose # FibonRose only
npm run dev:a11y # Accessibility nodes onlynpm run build # Build all workspacesnpm run test # Run all tests
npm run test:e2e # Run end-to-end testsnpm run lint # Lint all workspaces
npm run format # Format code with Prettier
npm run type-check # TypeScript type checkingnpm run db:setup # Setup databases
npm run db:migrate # Run migrations
npm run db:seed # Seed databasesnpm run docker:up # Start all services with Docker
npm run docker:down # Stop Docker services
npm run docker:logs # View Docker logs
npm run build:docker # Build Docker imagesThe platform includes a comprehensive webhook system for real-time event notifications:
# Start backend with webhook support
npm run dev:backend
# Access webhook API at http://localhost:3000/api/webhooksFeatures:
- Register and manage webhooks via REST API
- Receive webhooks from external services (Xano, Stripe, etc.)
- HMAC-SHA256 signature verification
- 12 predefined event types (user, auth, document, accessibility, sync, AI)
- Webhook delivery tracking and history
- Test endpoints for development
Documentation:
- Quick Start Guide - Get started in minutes
- API Reference - Complete API documentation
- Migration Guide - Migrate from Xano
The platform includes Model Context Protocol (MCP) server support in several services:
- DeafAUTH: Authentication and user management
- PinkSync: Real-time data synchronization
- FibonRose: Mathematical optimization
- Accessibility Nodes: Accessibility features API
- AI Services: AI-powered workflows
To run MCP servers individually:
npm run mcp --workspace=services/deafauth
npm run mcp --workspace=services/pinksync
npm run mcp --workspace=services/fibonrose
npm run mcp --workspace=services/accessibility-nodes
npm run mcp --workspace=aiEach workspace is independently versioned and can be developed, tested, and deployed separately.
- React 18 with TypeScript
- Vite for fast development
- Accessible UI components
- Sign language support
- Express.js REST API
- PostgreSQL database
- JWT authentication
- RESTful endpoints
- Specialized authentication service
- Accessible authentication flows
- MCP server for auth operations
- User preference management
- Real-time WebSocket synchronization
- Redis-based pub/sub
- MCP server for sync operations
- Event-driven architecture
- Mathematical optimization algorithms
- Fibonacci-based scheduling
- MCP server for optimization queries
- Performance analytics
- Modular accessibility features
- Sign language interpretation
- Visual accessibility enhancements
- MCP server for accessibility APIs
- AI-powered workflows
- Natural language processing
- Sign language generation
- MCP server for AI operations
Create a .env file in the root directory:
# Database
DATABASE_URL=postgresql://user:password@localhost:5432/deafirst
DEAFAUTH_DATABASE_URL=postgresql://user:password@localhost:5432/deafauth
# Redis
REDIS_URL=redis://localhost:6379
# JWT
JWT_SECRET=your-secret-key
JWT_EXPIRY=7d
#Paseto
# Frontend
VITE_API_URL=http://localhost:3000
VITE_WS_URL=ws://localhost:3001
# Services Pending
DEAFAUTH_PORT=3002
PINKSYNC_PORT=3003
FIBONROSE_PORT=3004
A11Y_PORT=3005
AI_PORT=8###
# MagicianCore Services
OPENAI_API_KEY=your-openai-key
# Webhook Configuration
WEBHOOK_SECRET=your-webhook-secret-key-hereWe welcome contributions! Please read our CONTRIBUTING.md guide before submitting PRs.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Make your changes following our code standards
- Run tests and linting (
npm run lint && npm run test) - Commit your changes (
git commit -m 'feat: add amazing feature') - Push to your branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Follow the Conventional Commits specification
- Maintain WCAG 2.1 AAA accessibility compliance
- Write tests for new features
- Update documentation as needed
- Ensure all CI checks pass
MIT License - see LICENSE file for details
360 Magicians
- Deaf-first design
- Accessibility
- SaaS ecosystem
- modules workflows
- http platform management
- Real-time synchronization
- Sign language support =======
A comprehensive platform built with deaf-first principles, providing accessible financial services, AI-powered assistance, and decentralized governance.
This repository contains OpenAPI specifications for all five core services of the MBTQ Universe:
Secure authentication system designed with deaf-first principles.
- Location:
services/deafauth/ - Base URL:
https://api.mbtquniverse.com/auth - Documentation: DeafAUTH README
- OpenAPI Spec: openapi.yaml
Real-time accessibility features and synchronization.
- Location:
services/pinksync/ - Base URL:
https://api.mbtquniverse.com/sync - Documentation: PinkSync README
- OpenAPI Spec: openapi.yaml
Decentralized trust and verification layer.
- Location:
services/fibonrose/ - Base URL:
https://api.mbtquniverse.com/blockchain - Documentation: Fibonrose README
- OpenAPI Spec: openapi.yaml
Intelligent automation and assistance agents.
- Location:
services/magicians/ - Base URL:
https://api.mbtquniverse.com/ai - Documentation: 360Magicians README
- OpenAPI Spec: openapi.yaml
Decentralized governance and community management.
- Location:
services/dao/ - Base URL:
https://api.mbtquniverse.com/dao - Documentation: DAO README
- OpenAPI Spec: openapi.yaml
β All endpoints documented with OpenAPI 3.1
β Standardized responses across all services
β Shared DeafAUTH security scheme
β Tags, components, pagination, error schemas
β Cloudflare-friendly JSON-only style
β Automated API testing with Jest
β SDK generation (TypeScript + Python)
β Production-ready specifications
All MBTQ Universe services use DeafAUTH for authentication. Include the Bearer token in the Authorization header:
Authorization: Bearer <your_token>- Register a new user:
curl -X POST https://api.mbtquniverse.com/auth/register \
-H "Content-Type: application/json" \
-d '{"email": "user@example.com", "password": "secure_password"}'- Login to get tokens:
curl -X POST https://api.mbtquniverse.com/auth/login \
-H "Content-Type: application/json" \
-d '{"email": "user@example.com", "password": "secure_password"}'- Use the access token for API calls:
curl -X GET https://api.mbtquniverse.com/sync/status \
-H "Authorization: Bearer <your_access_token>"Note: The endpoints below show full paths including the service prefix (e.g., /auth/, /sync/). In the OpenAPI specifications, these are defined as relative paths (e.g., /register, /status) with the base URL specified in the servers section.
POST /auth/register- User registrationPOST /auth/login- User authenticationGET /auth/verify- Token verificationPOST /auth/refresh- Token refresh
GET /sync/status- Check synchronization statusPOST /sync/preferences- Update accessibility preferencesGET /sync/features- List available accessibility features
POST /blockchain/verify- Verify blockchain transactionGET /blockchain/trust-score- Get trust scorePOST /blockchain/record- Record new transaction
Comprehensive AI agent platform with 60+ endpoints including:
- Agent management (CRUD operations)
- Task execution and workflow orchestration
- Memory and context management
- File ingestion and RAG search
- Tool registration and management
- Scheduling and webhooks
- Analytics and cost tracking
See 360Magicians README for complete endpoint list.
GET /dao/proposals- List governance proposalsPOST /dao/vote- Submit voteGET /dao/members- List DAO members
Copy .env.example to .env and configure your environment variables:
cp .env.example .envSee .env.example for all required configuration options.
Google Cloud Integration:
- Google Cloud Vision API for visual accessibility features
- Google Speech-to-Text for real-time captioning
- Google Translate API for multi-language support
- PinkSync API acts as an API broker network for partners' APIs that enhance deaf accessibility
AI SDK Integration:
The platform uses multiple AI models for comprehensive coverage:
- OpenAI: GPT-4, GPT-4 Turbo for natural language processing
- Anthropic: Claude 3 for advanced reasoning
- Google: Gemini Pro for multimodal tasks
- TensorFlow.js: Client-side AI processing
- Hugging Face Transformers: Specialized accessibility models
This platform integrates with several related repositories:
- pinkycollie/pinksync - Fastify-based accessibility engine
- pinkycollie/deafauth-ecosystem - Authentication ecosystem
- pinkycollie/fibonrose - Blockchain trust layer
- pinkycollie/pinkflow - Hub pipeline integrator
Run comprehensive API tests for all services:
# Install dependencies
npm install
# Run all tests
npm test
# Run tests with coverage
npm run test:coverage
# Run specific service tests
npm test -- tests/deafauth
npm test -- tests/pinksync
npm test -- tests/magiciansSee tests/README.md for detailed testing documentation.
Validate all OpenAPI specifications:
# Validate specs
npm run validate:openapiAll specifications are validated and ready for:
- Documentation generation
- SDK generation (TypeScript, Python, Go, etc.)
- API gateway configuration
- Testing and mocking
Generate client SDKs from OpenAPI specifications:
# Generate TypeScript SDK
npm run generate:sdk:typescript
# Generate Python SDK
npm run generate:sdk:python
# Generate all SDKs
npm run generate:sdkGenerated SDKs will be in the sdks/ directory. See SDK.md for detailed documentation and usage examples.
const deafAuthMiddleware = async (req, res, next) => {
const token = req.headers.authorization?.split(' ')[1];
if (!token) {
return res.status(401).json({ error: 'No token provided' });
}
try {
const decoded = await verifyDeafAuthToken(token);
req.user = decoded;
next();
} catch (error) {
return res.status(403).json({ error: 'Invalid token' });
}
};
module.exports = deafAuthMiddleware;const pinkSyncMiddleware = async (req, res, next) => {
const userId = req.user?.id;
if (userId) {
const preferences = await getPinkSyncPreferences(userId);
req.accessibilityPrefs = preferences;
}
next();
};
module.exports = pinkSyncMiddleware;# Clone the repository
git clone https://github.com/pinkycollie/DEAF-FIRST-PLATFORM.git
cd DEAF-FIRST-PLATFORM
# Install dependencies
npm installnpm run validate:openapi# Run all tests
npm test
# Run with coverage
npm run test:coverage# Generate TypeScript SDK
npm run generate:sdk:typescript
# Generate Python SDK
npm run generate:sdk:pythonSee SDK.md for usage examples with TypeScript and Python.
Generate interactive API documentation:
# TypeScript SDK
openapi-generator-cli generate \
-i services/deafauth/openapi/openapi.yaml \
-g typescript-axios \
-o sdks/typescript/deafauth
# Python SDK
openapi-generator-cli generate \
-i services/deafauth/openapi/openapi.yaml \
-g python \
-o sdks/python/deafauthEach service can be deployed as a Cloudflare Worker for edge computing benefits.
Use Redoc, Swagger UI, or other documentation tools to generate interactive API documentation.
Implement automated testing, validation, and deployment for all services.
- Complete Infrastructure Overview
- Individual service README files in each service directory
- OpenAPI specifications in
services/*/openapi/openapi.yaml
Contributions are welcome! Please ensure all changes maintain accessibility standards and deaf-first principles.
See LICENSE file for details.
Developer Certificate of Origin Version 1.1
Copyright (C) 2004, 2006 The Linux Foundation and its contributors. 660 York Street, Suite 102, San Francisco, CA 94110 USA
Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
Developer's Certificate of Origin 1.1
By making a contribution to this project, I certify that:
(a) The contribution was created in whole or in part by me and I have the right to submit it under the open source license indicated in the file; or
(b) The contribution is based upon previous work that, to the best of my knowledge, is covered under an appropriate open source license and I have the right under that license to submit that work with modifications, whether created in whole or in part by me, under the same open source license (unless I am permitted to submit under a different license), as indicated in the file; or
(c) The contribution was provided directly to me by some other person who certified (a), (b) or (c) and I have not modified it.
(d) I understand and agree that this project and the contribution are public and that a record of the contribution (including all personal information I submit with it, including my sign-off) is maintained indefinitely and may be redistributed consistent with this project or the open source license(s) involved. Built with deaf-first principles and a commitment to accessibility for all.
e961430