# Cloudron Packaging Shortlist

**Target**: Package 56 free/libre/open-source applications as Cloudron apps

## Packaging Priority Order

### Phase 1: Infrastructure & DevOps Tools (High Priority)
1. **Jenkins** - CI/CD Platform (Issue #234)
2. **Apache APISIX** - API Gateway (Issue #179)
3. **Rundeck** - Job Scheduler (Issue #217)
4. **Healthchecks** - Health Monitoring (Issue #192)
5. **Fleet** - Device Management (Issue #195)
6. **NetBox** - Network Documentation (Issue #201)
7. **SigNoz** - Observability Platform (Issue #221)

### Phase 2: Development & Productivity (High Priority)
8. **Grist** - Database/Spreadsheet (Issue #191)
9. **ReviewBoard** - Code Review (Issue #216)
10. **Huginn** - Web Automation (Issue #194)
11. **Windmill** - Workflow Automation (Issue #285)
12. **DocAssemble** - Document Assembly (Issue #277)
13. **WireFlow** - Flowchart Designer (Issue #50)
14. **Draw.io** - Diagram Editor (Issue #272)

### Phase 3: Business & Management (Medium Priority)
15. **InvenTree** - Inventory Management (Issue #173)
16. **OpenBoxes** - Supply Chain Management (Issue #205)
17. **Payroll Engine** - Payroll Management (Issue #208)
18. **Consul Democracy** - Democratic Platform (Issue #189)
19. **Fonoster** - Communications Platform (Issue #227)
20. **Craig** - Chat Platform (Issue #185)
21. **KillBill** - Billing Platform (Issue #181)

### Phase 4: Specialized Applications (Medium Priority)
22. **ELabFTW** - Laboratory Management (Issue #188)
23. **Jamovi** - Statistical Analysis (Issue #196)
24. **KiBot** - PCB Documentation (Issue #197)
25. **Resgrid** - Emergency Management (Issue #214)
26. **SatNOGS** - Satellite Network (Issue #218)
27. **SDR Angel** - Software Defined Radio (Issue #219)
28. **Warp** - Terminal (Issue #228)

### Phase 5: Advanced Tools (Lower Priority)
29. **GoAlert** - On-call Management (Issue #204)
30. **Hyperswitch** - Payment Processing (Issue #209)
31. **OpenFile** - Tax Filing (Issue #316)
32. **SniperPhish** - Security Training (Issue #211)
33. **DataHub** - Data Catalog (Issue #309)
34. **Easy Gate** - Access Control (Issue #54)
35. **Rathole** - Reverse Proxy (Issue #225) ✅ **COMPLETED**

### Phase 6: Infrastructure & Advanced (Lower Priority)
36. **SLURM** - Job Scheduler (Issue #222)
37. **TAK Server** - Military Communications (Issue #180)
38. **Midday** - AI Assistant (Issue #178)
39. **ChirpStack** - LoRaWAN (Issue #184)
40. **Mirlo** - Music Streaming (TBD)
41. **Nautilus Trader** - Trading Platform (Issue #226)
42. **RunMe** - Code Execution (Issue #322)

### Phase 7: Development & Research (Lower Priority)
43. **Seatunnel** - Data Processing (Issue #301)
44. **Docker Webhook** - Webhook Handler (Issue #271)
45. **Database Gateway** - Database Proxy (Issue #273)
46. **OpenBlocks** - Low-code Platform (Issue #274)
47. **WireViz** - Cable Documentation (Issue #276)
48. **AutoBOM** - Bill of Materials (Issue #278)
49. **PLMore** - Project Management (Issue #279)

### Phase 8: Specialized & Research (Lowest Priority)
50. **Manyfold** - 3D Modeling (Issue #282)
51. **Langfuse** - LLM Operations (Issue #283)
52. **Puter** - Cloud Desktop (Issue #286)
53. **SWUpdate** - Software Updates (Issue #326)
54. **Mender** - Device Management (Issue #300)
55. **Vanila Wireflow** - Flowchart (Issue #50)

## Packaging Strategy

### Container-Only Workflow
- All packaging work happens inside `KNELCloudron-packaging` container
- Use `scripts/packaging-exec.sh` for all build/test commands
- Follow validation checklist before committing

### Validation Requirements
- ✅ Build succeeds: `docker build -t <app>:dev CloudronPackages/<AppName>`
- ✅ Health check passes: container starts and responds to health endpoint
- ✅ Manifest validation: correct `id`, `version`, `httpPort`, `healthCheckPath`
- ✅ No secrets/credentials in code
- ✅ Proper `/app/data` ownership

### Commit Strategy
- Small, focused commits per application
- Use conventional commit format: `feat(<app>): initial Cloudron package`
- Batch pushes at natural milestones (5-10 apps per push)
- Never push unvalidated builds

## Estimated Timeline
- **Phase 1-2**: 2-3 weeks (14 apps)
- **Phase 3-4**: 3-4 weeks (14 apps) 
- **Phase 5-6**: 2-3 weeks (14 apps)
- **Phase 7-8**: 2-3 weeks (14 apps)
- **Total**: ~10-13 weeks for all 56 applications

## Notes
- Rathole is already completed and serves as reference implementation
- Each app will be packaged using `scripts/new-package.sh` scaffold
- Upstream sources available in `PackagingForCloudronWorkspace/Docker/`
- All work follows single-branch `main` workflow

---
**Created**: 2025-01-04  
**Maintainers**: KNEL/TSYS Development Team