My Dashboard Documentation
Welcome to the My Dashboard documentation! This is a comprehensive Cypress test results dashboard with JIRA integration, built as a full-stack TypeScript monorepo.
🎯 What is My Dashboard?
My Dashboard is a modern web application designed to aggregate, visualize, and manage Cypress E2E test results alongside development workflows. It provides:
- Real-time E2E Test Monitoring - Track Cypress test execution results across multiple applications
- Pull Request Integration - Monitor GitHub pull requests and their test status
- JIRA Integration - View and manage JIRA tickets directly from the dashboard
- Task Management - Built-in to-do list for tracking development tasks
- Push Notifications - Real-time alerts via Firebase Cloud Messaging
- Application Monitoring - Track multiple projects and their test health
🏗️ Architecture Overview
🚀 Technology Stack
Frontend
- React 19 - Modern React with latest features
- Vite - Fast build tool and development server
- TypeScript - Type-safe development
- Material-UI (MUI) - Component library
- React Router - Client-side routing
Backend
- Express.js - Web application framework
- TypeScript - Type-safe server code
- MySQL 8.0 - Relational database
- mysql2 - Database client (raw SQL)
Infrastructure
- pnpm - Fast, disk space efficient package manager
- Railway - Hosting and deployment
- GitHub Actions - CI/CD pipeline
- Docusaurus - Documentation site (this site!)
📚 Documentation Sections
Getting Started
- Getting Started - Setup and installation guide
Architecture
- Architecture Overview - System architecture and design
- Monorepo Structure - Workspace organization
- Client Architecture - Frontend architecture
- Server Architecture - Backend architecture
- Database Schema - Database design
- Deployment - Deployment architecture
- Security - Security implementation
Development
- Development Setup - Development environment
- Coding Standards - Code style and conventions
- Git Workflow - Branching and commits
- Testing - Testing guidelines
- CI/CD - Continuous integration and deployment
- Contributing - Contribution guidelines
- Troubleshooting - Common issues
SDK
- SDK Overview - TypeScript SDK introduction
- Installation - How to install the SDK
- Authentication - SDK authentication
- Usage Examples - Code examples
API Reference
- API Overview - API introduction
- Authentication - API authentication
- Error Handling - Error codes and responses
- Endpoints - API endpoint documentation
Other Resources
- AI Agent Instructions - Guidelines for AI coding agents
- FAQ - Frequently asked questions
- Glossary - Terms and definitions
🎓 Quick Links
- GitHub Repository: jayc13/my-dashboard
- OpenAPI Specification: API Documentation
- Live Documentation: GitHub Pages
🤝 Contributing
We welcome contributions! Please read our Contributing Guide to get started.
📝 License
This project is licensed under the terms specified in the LICENSE file.
Need Help? Check out our FAQ or Troubleshooting Guide.