How somunaexe/bulwriter works
Bulwriter is a collaborative screenwriting platform: writers open a project and script, edit a structured screenplay together in real time, and save named snapshots or branches for history and comparison. The editor also supports screenplay import/export and production-planning features such as breakdown, scheduling, casting, budgeting, scouting, shot lists, and press kits. The backend router exposes these domain APIs and the WebSocket sync hub; source excerpts confirm key wiring, while several feature implementations are only represented by the tree and API index.
Main entry points: api.go REST API · editor.component.ts Script editor · sync.service.ts Collab session · app.routes.ts App routes
Components 25
Angular client
- App routes
frontend/src/app/app.routes.ts - Project dashboard
frontend/src/app/components/dashboard/dashboard.component.ts - Project workspace
frontend/src/app/components/project/project.component.ts
Screenplay authoring
- Script editor
frontend/src/app/components/editor/editor.component.ts - Collab session
frontend/src/app/services/sync.service.ts - Screenplay model
frontend/src/app/editor/screenplay-schema.ts - Fountain interchange
frontend/src/app/editor/fountain-export.ts - Branch history UI
frontend/src/app/components/branch-panel/branch-panel.component.ts - Draft comparison
frontend/src/app/components/diff-viewer/diff-viewer.component.ts - Version control client
frontend/src/app/services/version-control.service.ts
Backend services
- REST API
backend/internal/api/api.go - WebSocket hub
backend/internal/hub/hub.go - Snapshots and branches
backend/internal/snapshot/snapshot.go
Film production
- Scene breakdown
backend/internal/breakdown/breakdown.go - Production schedule
backend/internal/schedule/schedule.go - Casting
backend/internal/casting/casting.go - Budget
backend/internal/budget/budget.go - Location scouting
backend/internal/scouting/scouting.go - Shot list
backend/internal/shotlist/shotlist.go - Press kit
backend/internal/presskit/presskit.go - Production tools UI
frontend/src/app/components/stripboard/stripboard.component.ts
Projects and access
- Project and script data
backend/internal/project/project.go - Membership and invites
backend/internal/membership/membership.go - Identity client
frontend/src/app/services/clerk.service.ts
Other components
- Writer
Connections 31
- Writer → App routes: opens workspace
frontend/src/app/app.routes.ts - App routes → Project dashboard: routes to
frontend/src/app/app.routes.ts - App routes → Project workspace: routes to
frontend/src/app/app.routes.ts - App routes → Script editor: routes to
frontend/src/app/app.routes.ts - Project dashboard → Project workspace: opens project
frontend/src/app/components/dashboard/dashboard.component.ts - Project workspace → Script editor: opens script
frontend/src/app/components/project/project.component.ts - Script editor → Collab session: starts session
frontend/src/app/components/editor/editor.component.ts - Collab session → WebSocket hub: syncs updates
README.md - WebSocket hub → Collab session: broadcasts updates
README.md - Collab session → Screenplay model: builds editor
frontend/src/app/services/sync.service.ts - Collab session → Fountain interchange: exports text
frontend/src/app/services/sync.service.ts - Script editor → Fountain interchange: imports and exports
frontend/src/app/components/editor/editor.component.ts - Script editor → Version control client: saves drafts
frontend/src/app/components/editor/editor.component.ts - Script editor → Branch history UI: shows branches
frontend/src/app/components/editor/editor.component.ts - Script editor → Draft comparison: shows diffs
frontend/src/app/components/editor/editor.component.ts - Branch history UI → Version control client: requests history
- Draft comparison → Version control client: requests comparison
- Version control client → REST API: calls REST
README.md - REST API → Snapshots and branches: reads and writes
backend/internal/api/api.go - REST API → WebSocket hub: routes WebSocket
README.md - REST API → Project and script data: reads and writes
backend/internal/api/api.go - REST API → Membership and invites: checks access
backend/internal/api/api.go - Identity client → Writer: authenticates
- Script editor → Production tools UI: opens production tools
frontend/src/app/components/editor/editor.component.ts - REST API → Scene breakdown: serves breakdown
backend/internal/api/api.go - REST API → Production schedule: serves schedule
backend/internal/api/api.go - REST API → Casting: serves casting
backend/internal/api/api.go - REST API → Budget: serves budgets
backend/internal/api/api.go - REST API → Location scouting: serves scouting
backend/internal/api/api.go - REST API → Shot list: serves shot lists
backend/internal/api/api.go - REST API → Press kit: serves press kits
backend/internal/api/api.go