A comprehensive project management and collaboration platform built specifically for development teams. Worklamp combines task tracking, bug management, feature requests, team communication, and AI-powered development workflows into a single, secure, self-hosted solution.

Visit: https://worklamp.com

U: [email protected] / P: TestPass123!

-- OR --

Sign Up with Google (easiest) or a valid email address. You can work on one project and use all functions. Team Settings are not developed completely yet and are not available in Demo.

• Multi-Project Support - Manage multiple projects with tenant isolation
• Milestone Tracking - Visual timeline with version locking and change order management
• Task Management - Organize tasks by categories, priorities, and milestones
• Custom Workflows - Flexible status tracking (To Do, In Progress, Done)

• Bug Tracking - Report bugs with screenshots, URLs, and priority levels
• Feature Requests - Collect and prioritize feature ideas with voting
• Public Access - Optional public bug/feature tracking for community input
• Vote System - Let users vote on bugs and features to prioritize work

• Real-Time Chat - Slack-like team communication with channels
• Role-Based Access - Owner, Admin, Developer, and Auditor roles
• Team Invitations - Email-based team member invitations
• Live Updates - WebSocket-powered real-time dashboard updates

• Bug Analysis - AI-powered bug fix suggestions and solutions
• Feature Specifications - Auto-generate detailed feature specs
• AI Agent Prompts - Generate prompts for AI coding assistants
• Spec File Integration - Upload requirements, design, and task files for context

• Multi-Tenant Architecture - Complete data isolation between tenants
• Email/Password Auth - Secure local authentication with bcrypt
• Google OAuth - Single sign-on with Google accounts
• JWT Sessions - Secure token-based authentication with refresh tokens
• Role-Based Permissions - Granular access control for all features

• Project Files - Upload and manage project documentation
• Environment Variables - Secure, encrypted storage for dev/prod configs
• Personal Notes - Post-it style notes for quick reminders
• Image Optimization - Automatic image compression and optimization

• Email Notifications - Notify admins of new bugs and feature requests
• Email Verification - Secure account activation
• Newsletter System - Built-in newsletter subscription management
• MJML Templates - Beautiful, responsive email templates

• Dark/Light Mode - Theme toggle with localStorage persistence
• Responsive Design - Mobile-optimized interface
• Real-Time Indicators - Live connection status and "new" badges
• Minimal UI - Clean, efficient design with minimal clicks

• Self-Hosted - Run on your own infrastructure
• Docker Support - Easy deployment with Docker Compose
• REST API - Well-documented RESTful API
• WebSocket Events - Real-time event system
• TypeScript - Full type safety across the stack
• Property-Based Testing - Comprehensive test coverage with fast-check

• Free Tier - 1 project, basic task management
• Paid Tier - Unlimited projects, team features, milestones, and chat

This is a monorepo containing:

• frontend/ - Next.js 14+ application with TypeScript and App Router
• backend/ - Express.js API server with TypeScript
• shared/ - Shared types, constants, and validators

• Node.js 20+ LTS
• PostgreSQL 15+
• Redis
• npm or yarn

# Install dependencies for all workspaces
npm install

1. Copy the example environment file in the backend:

cp backend/.env.example backend/.env

2. Update the environment variables in backend/.env with your configuration.

# Run both frontend and backend in development mode
npm run dev

# Run frontend only
npm run dev:frontend

# Run backend only
npm run dev:backend

The frontend will be available at http://localhost:3000 The backend API will be available at http://localhost:3001

# Build all workspaces
npm run build

# Run tests for all workspaces
npm run test

# Lint all workspaces
npm run lint

# Format all files
npm run format

• Next.js 14+ (App Router)
• React 18+
• TypeScript
• Tailwind CSS
• React Query (TanStack Query)
• Zustand
• Socket.io-client
• Zod

• Node.js 20+
• Express.js
• TypeScript
• Prisma ORM
• PostgreSQL
• Redis
• Socket.io
• Passport.js
• JWT Authentication

• Vitest
• React Testing Library
• Supertest
• fast-check (Property-Based Testing)

See the /DOCS directory for detailed documentation:

• API documentation: /DOCS/api/
• Testing documentation: /DOCS/testing/
• Deployment guides: /DOCS/deployment/

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

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

• ✅ Commercial use allowed
• ✅ Modification allowed
• ✅ Distribution allowed
• ✅ Private use allowed
• ⚠️ No warranty provided
• ⚠️ No liability accepted

For issues, questions, or contributions, please open an issue on GitHub.

Built with modern web technologies and best practices for enterprise-grade project management.