How profvhs/corkboard works
Corkboard is a real-time project-management application: users work in workspace-scoped release boards and backlogs, manage tasks and tags, and collaborate on workspace documents. The React client presents these workflows and communicates with a Rails backend; Rails routes requests to domain controllers, which persist project data and publish updates. Action Cable and the separate collaboration package support live behavior. The README documents the product capabilities, while the sampled controller and routing excerpts provide only limited implementation-level evidence, so unsampled connections are not asserted.
Main entry points: routes.rb HTTP routes · schema.rb PostgreSQL · main.tsx App routes · tasks_controller.rb Task endpoints
Components 26
React client
- App routes
corkboard-frontend/src/main.tsx - Release boards
corkboard-frontend/src/pages/CurrentReleasePage/CurrentReleasePage.tsx - Backlog
corkboard-frontend/src/pages/BacklogPage/BacklogPage.tsx - Document editor
corkboard-frontend/src/components/features/Documents/Documents.tsx - Workspace settings
corkboard-frontend/src/components/features/Settings/WorkspaceGeneral/WorkspaceGeneral.tsx - Task status UI
corkboard-frontend/src/components/ui/Popovers/TaskStatusPopover/useTaskStatusPopover.ts - Tag manager
corkboard-frontend/src/components/features/Settings/TagsManager/TagsManager.tsx - HTTP API client
corkboard-frontend/src/api/api.ts
Rails API
- HTTP routes
corkboard-backend/config/routes.rb - Task endpoints
corkboard-backend/app/controllers/tasks_controller.rb - Workspace endpoints
corkboard-backend/app/controllers/workspaces_controller.rb - Release endpoints
corkboard-backend/app/controllers/releases_controller.rb - Document endpoints
corkboard-backend/app/controllers/documents_controller.rb - Tag endpoints
corkboard-backend/app/controllers/tags_controller.rb
Project domain
- Task records
corkboard-backend/app/models/task.rb - Workspace records
corkboard-backend/app/models/workspace.rb - Release records
corkboard-backend/app/models/release.rb - Document records
corkboard-backend/app/models/document.rb - Tag records
corkboard-backend/app/models/tag.rb - PostgreSQL
corkboard-backend/db/schema.rb
Live collaboration
- Action Cable channels
corkboard-backend/app/channels/workspace_channel.rb - Workspace broadcaster
corkboard-backend/app/broadcasters/workspace_broadcaster.rb - Document collaboration
corkboard-collaboration/src/index.ts
Identity and preferences
- Session endpoints
corkboard-backend/app/controllers/users/sessions_controller.rb - User preferences
corkboard-backend/app/controllers/user_preferences_controller.rb
Other components
- Team member
Connections 31
- Team member → App routes: uses
corkboard-frontend/src/main.tsx - App routes → Release boards: routes to
corkboard-frontend/src/main.tsx - App routes → Backlog: routes to
corkboard-frontend/src/main.tsx - App routes → Document editor: routes to
corkboard-frontend/src/main.tsx - App routes → Workspace settings: routes to
corkboard-frontend/src/main.tsx - Release boards → Task status UI: updates status
- Task status UI → HTTP API client: requests update
- Tag manager → HTTP API client: requests tags
corkboard-frontend/src/components/features/Settings/TagsManager/TagsManager.tsx - HTTP API client → HTTP routes: sends requests
- HTTP routes → Task endpoints: routes tasks
corkboard-backend/config/routes.rb - HTTP routes → Workspace endpoints: routes workspaces
corkboard-backend/config/routes.rb - HTTP routes → Release endpoints: routes releases
corkboard-backend/config/routes.rb - HTTP routes → Document endpoints: routes documents
corkboard-backend/config/routes.rb - HTTP routes → Tag endpoints: routes tags
corkboard-backend/config/routes.rb - HTTP routes → Session endpoints: routes sessions
corkboard-backend/config/routes.rb - Task endpoints → Task records: creates and updates
corkboard-backend/app/controllers/tasks_controller.rb - Task endpoints → Document records: creates document
corkboard-backend/app/controllers/tasks_controller.rb - Task endpoints → Workspace broadcaster: broadcasts changes
corkboard-backend/app/controllers/tasks_controller.rb - Workspace endpoints → Workspace records: updates workspace
corkboard-backend/app/controllers/workspaces_controller.rb - Release endpoints → Release records: manages releases
- Document endpoints → Document records: manages documents
- Tag endpoints → Tag records: manages tags
- Session endpoints → Team member: authenticates
corkboard-backend/app/controllers/users/sessions_controller.rb - Action Cable channels → Team member: streams updates
- Document collaboration → Document editor: enables live editing
- Task records → PostgreSQL: persists
- Workspace records → PostgreSQL: persists
- Release records → PostgreSQL: persists
- Document records → PostgreSQL: persists
- Tag records → PostgreSQL: persists
- User preferences → PostgreSQL: persists