The Future of Test Case Management & Project Automation
Live Demo • Documentation • CLI Package • Discord • Report Bug
Manage test steps, statuses, and expected results in a clean, intuitive UI.
Labnex is a platform aimed at improving testing and project management workflows for developers and testers. Its core components include a command-line interface (CLI) for automated local test execution, AI-driven features for test generation and analysis, and Discord integration for AI assistance. Project and test case data are managed via a central backend service.
- AI-Assisted Test Generation: Helps create test steps from natural language.
- CLI for Local Browser Testing: Executes automated browser tests on your machine.
- Detailed Console Logging: Shows real-time test progress and actions in the terminal.
- Backend for Test Case Storage: Manages test case data through an API.
- Discord Bot for AI Help: Provides AI-driven assistance via Discord.
- JWT-Based Authentication: Secures access using JSON Web Tokens.
- Focus on AI in Testing: Aims to use AI to simplify aspects of the testing process.
- Local-First Test Execution: Prioritizes running tests directly on the developer's environment via CLI.
- Developer-Oriented Tools: Provides tools like the CLI designed for developer workflows.
- Modular Components: Built with separate frontend, backend, and CLI components.
Labnex follows a modern, scalable architecture:
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Frontend │ │ Backend │ │ CLI Package │
│ (React) │◄──►│ (Node.js) │◄──►│ (TypeScript) │
│ │ │ │ │ │
│ • Modern UI │ │ • REST APIs │ │ • Enhanced │
│ • Real-time │ │ • WebSockets │ │ Logging │
│ • TypeScript │ │ • AI Services │ │ • Performance │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │ │
└───────────────────────┼───────────────────────┘
│
┌─────────────────┐
│ Database │
│ (MongoDB) │
│ │
│ • Projects │
│ • Test Cases │
│ • Test Runs │
└─────────────────┘
- Node.js 18.0.0 or higher
- npm or yarn
- MongoDB (local or cloud)
- Git
-
Clone the repository
git clone https://github.com/LabnexDev/Labnex.git cd Labnex -
Install dependencies
# Install backend dependencies cd backend && npm install # Install frontend dependencies cd ../frontend && npm install # Install CLI dependencies cd ../packages/cli && npm install
-
Environment Setup
# Backend environment cp backend/.env.example backend/.env # Edit backend/.env with your configuration # Frontend environment cp frontend/.env.example frontend/.env # Edit frontend/.env with your configuration
-
Start the application
# Start backend (from backend directory) npm run dev # Start frontend (from frontend directory) npm run dev # Build CLI (from packages/cli directory) npm run build
-
Access the application
- Frontend: http://localhost:5173
- Backend API: http://localhost:5000
- CLI:
node dist/index.js --help
- React 18 - Modern UI library with hooks
- TypeScript - Type-safe development
- Vite - Lightning-fast build tool
- Tailwind CSS - Utility-first CSS framework
- React Query - Powerful data synchronization
- Framer Motion - Smooth animations
- Heroicons - Beautiful SVG icons
- Node.js - JavaScript runtime
- Express.js - Web application framework
- TypeScript - Type-safe server development
- MongoDB - NoSQL database
- Mongoose - MongoDB object modeling
- JWT - Secure authentication
- WebSockets - Real-time communication
- Commander.js - Command-line interface framework
- Chalk - Terminal string styling
- Ora - Elegant terminal spinners
- TypeScript - Type-safe CLI development
- OpenAI API - AI-powered features
- Discord.js - Discord bot integration
- WebSocket - Real-time updates
All essential documentation is provided within this README. For further details on contributing, see CONTRIBUTING.md.
For advanced usage or troubleshooting, join our Discord community or report bugs.
Labnex includes a powerful CLI. Install it globally or use with npx:
npm install -g @labnex/cli
# or
npx @labnex/cli <command>Find the package on npm: @labnex/cli.
# Run tests with AI optimization
labnex run --project <project-id> --ai-optimize
# Run tests with detailed logging
labnex run --project <project-id> --ai-optimize --detailed
# Generate test cases with AI
labnex ai generate --description "User login functionality"
# Analyze test failures
labnex ai analyze <run-id> <failure-id>
# Check system status
labnex statusWith the --detailed flag, get comprehensive test execution logs:
- Real-time action tracking (navigation, clicks, typing)
- Performance metrics (page load times, response times)
- Visual progress bars and completion statistics
- Detailed error reporting and debugging information
We welcome contributions! Please see our Contributing Guide for details.
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests
- Submit a pull request
- TypeScript for type safety
- ESLint for code quality
- Prettier for code formatting
- Jest for testing
- Conventional commits
- Fast: Sub-second page loads with optimized bundling
- Responsive: Mobile-first design with 100% responsive layouts
- Secure: Enterprise-grade security with JWT and role-based access
- Scalable: Microservices architecture supporting thousands of users
- Global: CDN-optimized for worldwide performance
Labnex takes security seriously:
- JWT-based authentication
- Role-based access control (RBAC)
- Input validation and sanitization
- HTTPS enforcement
- Regular security audits
- OWASP compliance
This project is licensed under the MIT License - see the LICENSE file for details.
- Built with love by the Labnex team
- Powered by OpenAI for AI features
- Icons by Heroicons
- UI components inspired by modern design systems
- Documentation: Visit our Documentation
- Discord Community: Join our Discord
- GitHub Issues: Report bugs or request features
- Email: labnexcontact@gmail.com
Made with love for the developer community