How aditi3175/devboard-x works
DevBoard X is a project workspace for builders: users organize projects, tasks, resources, and snippets, edit task files, and execute code in an integrated workspace. Convex supplies synchronized project data and analytics; GitHub OAuth and repository publishing are optional integrations. The README documents the product capabilities, while sampled source confirms task-to-activity behavior, project data merging, and OAuth/publishing calls. Several feature modules were not sampled, so their internal wiring is not asserted.
Main entry points: schema.ts Convex Data Store · tasks.ts Tasks · ProjectContext.jsx Project Data Context · files.ts Workspace Files
Components 20
Workspace
- Dashboard and Project UI
devboard-x/src/app/(app)/projects/[id]/page.js - Task Editor
devboard-x/src/app/(app)/projects/[id]/tasks/[taskId]/page.js - Workspace Interface
devboard-x/src/components/layout/Workspace.jsx - Settings and Backup
devboard-x/src/app/(app)/settings/page.js - Project Data Context
devboard-x/src/context/ProjectContext.jsx
Project Data
- Projects
devboard-x/convex/projects.ts - Tasks
devboard-x/convex/tasks.ts - Resources
devboard-x/convex/resources.ts - Code Snippets
devboard-x/convex/snippets.ts - Workspace Files
devboard-x/convex/files.ts - Activity Feed
devboard-x/convex/activity.ts - Convex Data Store
devboard-x/convex/schema.ts
Execution and Insights
- Code Execution
devboard-x/convex/execution.ts - Project Analytics
devboard-x/src/app/(app)/analytics/page.js - Global Search
devboard-x/convex/search.ts
Connected Services
- GitHub OAuth Routes
devboard-x/src/app/api/github/callback/route.js - GitHub Repository Actions
devboard-x/convex/githubActions.ts - GitHub Connections
devboard-x/convex/github.ts
Other components
- Builder
- GitHub
Connections 22
- Builder → Dashboard and Project UI: manages projects
- Builder → Task Editor: edits tasks
- Task Editor → Workspace Interface: opens workspace
- Project Data Context → Projects: queries and mutates
devboard-x/src/context/ProjectContext.jsx - Project Data Context → Tasks: queries and mutates
devboard-x/src/context/ProjectContext.jsx - Project Data Context → Workspace Files: queries and mutates
devboard-x/src/context/ProjectContext.jsx - Tasks → Activity Feed: logs events
devboard-x/convex/tasks.ts - Tasks → Workspace Files: deletes task files
devboard-x/convex/tasks.ts - Tasks → Convex Data Store: reads and writes
- Projects → Convex Data Store: reads and writes
- Resources → Convex Data Store: reads and writes
- Code Snippets → Convex Data Store: reads and writes
- Workspace Files → Convex Data Store: reads and writes
- Builder → Settings and Backup: configures workspace
- Settings and Backup → Project Data Context: uses project state
devboard-x/src/app/(app)/settings/page.js - Workspace Interface → Code Execution: runs code
- Builder → Project Analytics: views analytics
- Builder → Global Search: searches workspace
- GitHub OAuth Routes → GitHub: exchanges OAuth token
devboard-x/src/app/api/github/callback/route.js - GitHub OAuth Routes → GitHub Connections: stores connection
devboard-x/src/app/api/github/callback/route.js - GitHub Repository Actions → GitHub Connections: gets decrypted token
devboard-x/convex/githubActions.ts - GitHub Repository Actions → GitHub: publishes repository changes
devboard-x/convex/githubActions.ts