Optimum Solutions Group

🚀 A modern, performance-optimized React application with enterprise-grade monitoring and testing.

📊 Project Status

Badges are automatically updated based on the latest performance monitoring data.

Introduction

Optimum Solutions Group is built with Vite, TypeScript, React, shadcn-ui, and Tailwind CSS. It features automated performance monitoring, accessibility compliance (WCAG 2.1 AA), comprehensive testing (Jest, Cypress), and a live performance dashboard.

Live Dashboard: https://mbwk25.github.io/optimum-solutions-group
Project: https://lovable.dev/projects/191a8a44-4ca1-4155-9cf6-8342ccbd4142

Quick Start

git clone <YOUR_GIT_URL>
cd <YOUR_PROJECT_NAME>
npm i
npm run dev

For analytics and API features: copy .env.example to .env and fill in your values.

Documentation Index

All project documentation lives in the docs folder. See docs/README.md for the full index.

Section	Description
Guides	Setup guides, analytics, accessibility, deployment, Cypress, GitHub Actions
Deployment	Deployment readiness, guides, and quick-start
Testing	Testing standards and status reports
Analysis	Project analysis and audits
Architecture	Architecture diagrams and visuals
Optimization Project	Optimization roadmap, backlogs, architecture, risks
API	OpenAPI spec, Postman collection, environments

Key Documents

• Documentation Index — Full documentation index
• Deployment Guide
• Accessibility Guide
• Analytics Documentation
• Testing Standards
• Technical Audit Report
• Optimization Project Overview
• GitHub Issues Template — Copy-paste ready issue templates

Commands

Command	Description
npm run dev	Start development server
npm test	Run tests
npm run test:coverage	Run tests with coverage
npm run deploy:workflow	Deploy workflow instructions
npm run analyze:bundle	Analyze bundle size

How to Edit

• Lovable: Edit via Lovable — changes auto-commit
• IDE: Clone, edit locally, push — changes sync to Lovable
• GitHub: Edit files directly in the repo
• Codespaces: Use GitHub Codespaces for a cloud dev environment

Deploy

Open Lovable → Share → Publish.
Custom domains: Project > Settings > Domains.