A comprehensive manual test case management platform with GitHub integration, built with Next.js 15 and modern web technologies.

• Manual Test Case Creation: Rich editor with step-by-step test creation
• Test Case Management: Full CRUD operations with metadata tracking
• Batch Test Execution: Select and run multiple test cases simultaneously
• Individual Test Execution: Step-by-step execution with real-time results

• Live Statistics: Test execution counts, pass rates, and trends
• Activity Feed: Recent test runs and case modifications
• Progress Tracking: Visual progress bars and completion statistics
• Export Capabilities: CSV export for detailed reporting

• OAuth Authentication: Secure GitHub login
• Issue Browsing: View and select GitHub issues for testing
• AI-Powered Generation: Automatically generate test cases from issues
• Repository Integration: Connect tests to specific GitHub repositories

• Dark/Light Themes: Professional theming with shadcn/ui components
• Responsive Design: Works seamlessly on desktop and mobile
• Accessibility: WCAG compliant with proper contrast ratios
• Modern Stack: Next.js 15, TypeScript, Tailwind CSS

• Frontend: Next.js 15.4.2 with App Router
• UI Framework: shadcn/ui + Radix UI components
• Styling: Tailwind CSS v4 with custom theming
• Authentication: NextAuth.js with GitHub OAuth
• Data Storage: File-based system with Markdown and JSON
• AI Integration: OpenAI API for test case generation
• GitHub API: Octokit for repository and issue management

• Node.js 18 or higher
• npm or yarn package manager
• Git for version control
• GitHub account (for OAuth authentication)
• OpenAI API key (optional, for AI test case generation)

1. Clone the repository

   git clone https://github.com/synjan/qa-demo-1.git cd qa-demo-1

2. Install dependencies

   npm install

3. Environment setup

   cp .env.example .env.local

4. Configure environment variables

   # NextAuth Configuration NEXTAUTH_URL=http://localhost:3000 NEXTAUTH_SECRET=your-secret-key-here # GitHub OAuth GITHUB_CLIENT_ID=your-github-oauth-app-client-id GITHUB_CLIENT_SECRET=your-github-oauth-app-secret # OpenAI API (Optional) OPENAI_API_KEY=your-openai-api-key # GitHub Personal Access Token (Optional) GITHUB_TOKEN=your-github-personal-access-token

5. GitHub OAuth Setup

   • Go to GitHub Developer Settings
   • Create a new OAuth App with:
     • Homepage URL: http://localhost:3000
     • Authorization callback URL: http://localhost:3000/api/auth/callback/github

6. Start the development server

   npm run dev

7. Open in browser Navigate to http://localhost:3000

graph LR A[Create Test Case] --> B[Add Steps] B --> C[Set Priority] C --> D[Save & Execute] D --> E[Track Results] 

graph LR A[Select Multiple Tests] --> B[Start Batch Run] B --> C[Execute Sequentially] C --> D[Aggregate Results] D --> E[Export Report] 

graph LR A[Connect GitHub] --> B[Browse Issues] B --> C[Generate Tests] C --> D[Execute & Track] D --> E[Link Results] 

qa-demo-1/ ├── src/ │ ├── app/ # Next.js App Router pages │ │ ├── api/ # API endpoints │ │ ├── testcases/ # Test case management pages │ │ ├── testplans/ # Test plan management pages │ │ └── github/ # GitHub integration pages │ ├── components/ # Reusable UI components │ │ ├── ui/ # shadcn/ui components │ │ ├── layout/ # Layout components │ │ └── theme/ # Theme components │ └── lib/ # Utility functions and types ├── testcases/ # Test case storage (Markdown) ├── testplans/ # Test plan storage (JSON) ├── results/ # Test results storage (JSON) └── README.md 

• Git-friendly: Version control for test cases
• No Database Required: Simple deployment
• Human Readable: Markdown and JSON formats
• Portable: Easy backup and migration

• Auto-Generation: Create test cases from GitHub issues
• Smart Analysis: AI understands issue context
• Customizable: Edit generated test cases
• Integration: Seamless workflow with GitHub

• Sequential Processing: Execute multiple tests in order
• Real-time Progress: Live updates and statistics
• Auto-save Results: Automatic result persistence
• Export Reports: CSV export for analysis

🏠 Visit the Wiki for comprehensive documentation

• 📖 Installation Guide - Complete setup instructions with troubleshooting
• 📘 User Manual - Detailed feature documentation and workflows
• 🔧 API Reference - Complete API documentation with examples
• ✨ Features - Comprehensive feature overview
• 🤝 Contributing - Development guidelines and workflow
• 🚨 Troubleshooting - Common issues and solutions

npm install -g vercel vercel --prod

docker build -t qa-test-manager . docker run -p 3000:3000 qa-test-manager

npm run build npm start

For detailed deployment instructions, see the Wiki documentation.

We welcome contributions! Please see our Contributing Guide for details.

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Make your changes
4. Run tests: npm test
5. Commit changes: git commit -m 'Add amazing feature'
6. Push to branch: git push origin feature/amazing-feature
7. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

• 📚 Wiki Documentation - Complete documentation hub
• 🚀 Latest Release - Download and release notes
• 🐛 GitHub Issues - Bug reports and feature requests
• 💬 GitHub Discussions - Community discussions

Need help? Here are your options:

• 📚 Documentation: GitHub Wiki - Comprehensive guides and documentation
• 🚨 Troubleshooting: Troubleshooting Guide - Common issues and solutions
• 🐛 Bug Reports: GitHub Issues - Report bugs and request features
• 💬 Questions: GitHub Discussions - Ask questions and get help

• Built with Next.js
• UI components by shadcn/ui
• Icons by Lucide
• Styling with Tailwind CSS

QA Test Manager - Making manual testing efficient and enjoyable! 🎉