Project Management for Frappe Framework

Orga is a project management app built on Frappe Framework. It provides Kanban boards, Gantt charts, resource planning, and automation — designed for teams who need project tracking within their Frappe ecosystem.

Part of the Tonic ecosystem. Integrates with Dock for calendar, notifications, search, and the people hub, and with Watch for time tracking.

Organize work into projects with automatic code generation, progress tracking, and health monitoring.

• Auto-generated project codes (ORG-YYYY-NNNN)
• Lifecycle stages: Planning, Active, On Hold, Completed
• Progress calculated automatically from task completion
• Budget tracking
• Project manager assignment and department linking

Break down projects into tasks with priorities, assignments, deadlines, and dependencies.

• Four-column Kanban board with drag-and-drop
• List view
• Priority levels (Urgent, High, Medium, Low)
• Task checklists with completion tracking
• Task dependencies with circular detection
• Subtask support

Plan timelines with an interactive Gantt chart showing dependencies and progress.

• Timeline view with task bars and milestones
• Visual dependency lines
• Today marker
• Cascade preview for date change impact
• Click-to-edit via focus panel

Track team members, skills, and workload allocation across projects.

• Team member profiles with capacity settings
• Skills tracking with proficiency levels
• Workload visualization with utilization percentages
• Assignment management with allocated hours
• Overallocation warnings

Coordinate meetings, deadlines, and milestones with attendee tracking and reminders.

• Meeting, deadline, review, and milestone types
• Invite attendees with RSVP tracking
• Automatic email reminders
• Location and meeting URL support
• Synced to Dock's unified calendar for viewing

Automatic health scoring identifies at-risk projects.

• Weighted scoring based on schedule, budget, tasks, and milestones
• Green / Yellow / Red status indicators
• Actionable improvement recommendations

Automate repetitive tasks with event-driven rules.

• Trigger on create, update, status change, or assignment
• Condition-based execution
• Actions: set field values, assign users, send notifications, add comments

Register external clients and grant portal access to view project progress.

• Client management with contact details
• Link clients to projects
• Portal access with automatic user provisioning (via Dock portal framework)
• Clients see only their linked projects

• Project Summary
• Resource Utilization
• Task Completion
• Budget Tracking
• Milestone

• Dock: Calendar sync, notifications, activity feed, people hub, global search, settings hub
• Watch: Time tracking on tasks, projects, and appointments
• Webhooks: Notify external systems on 25+ event types with HMAC signing
• Import/Export: Bulk operations via CSV and JSON
• Frappe Projects: Optional two-way sync with built-in Projects module
• ERPNext: Link resources to Employees, export time logs to Timesheets

• Frappe Framework v16+
• Dock (required dependency)
• Python 3.14+
• Node.js 24+
• MariaDB 10.6+

# Get the app
bench get-app orga https://github.com/tonic-6101/orga.git

# Install on your site
bench --site your-site.localhost install-app orga

# Run migrations
bench --site your-site.localhost migrate

# Build assets
bench build --app orga

Frappe Manager provides a Docker-based environment with a GUI for managing Frappe sites — no manual bench setup required.

1. Install Frappe Manager following the official instructions

2. Create a new site (or use an existing one):

   fm create mysite

3. Install Dock (required dependency) and Orga on your site:

   fm shell mysite
   # Inside the container:
   cd /workspace/frappe-bench
   bench get-app dock https://github.com/tonic-6101/dock.git
   bench get-app orga https://github.com/tonic-6101/orga.git
   bench --site mysite.localhost install-app dock
   bench --site mysite.localhost install-app orga
   bench --site mysite.localhost migrate
   bench build --app orga

4. Access your site at https://mysite.localhost

After installation, access Orga at: https://your-site.localhost/orga

1. Create a Project — Navigate to Projects and click "New Project"
2. Add Tasks — Open your project and add tasks to the Kanban board
3. Assign Resources — Create resources and assign them to tasks
4. Track Progress — Project progress updates automatically from task completion
5. Schedule Appointments — Create appointments that sync to Dock's calendar

• Backend: Frappe Framework v16+, Python
• Frontend: Vue 3, TypeScript, Tailwind CSS, FrappeUI
• Database: MariaDB

We welcome contributions! Please see CONTRIBUTING.md before submitting pull requests.

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

This repo ships with configuration files for AI coding agents:

• AGENTS.md — Repository guidelines, coding conventions, build commands, commit format, and Frappe v16 gotchas. AI agents (and human contributors) should read this before making changes.
• CLAUDE.md — Points to AGENTS.md. If you use Claude Code, it picks this up automatically as project context.

If you're contributing with an AI assistant, point it at AGENTS.md to get up to speed on the project's conventions quickly.

• Issues: GitHub Issues
• Discussions: GitHub Discussions

GNU Affero General Public License v3.0 (AGPL-3.0)

See LICENSE for details.

Built with Frappe Framework and FrappeUI.