How usebruno/bruno works
Bruno is an offline API client whose collections are stored as plain-text Bru files and can be version-controlled locally. The desktop workflow is to open a collection, configure requests and environments, execute requests, and inspect results; the CLI can run collections too. The map also preserves documented conversion, mock-server, and protocol capabilities visible in the repository tree. Some central Electron request-preparation and collection-watching modules are named by the source index but not present in the supplied tree, so their links are left unverified rather than asserted as observed calls.
Main entry points: Main.js Desktop workspace · network Request preparation · collection-watcher.js Collection watcher · grpc-event-handlers.js gRPC handlers
Components 20
Client experience
- Desktop workspace
packages/bruno-app/src/pages/Main.js - Request editor
packages/bruno-app/src/components/RequestPane - Environment settings
packages/bruno-app/src/components/Environments - AI assistant
packages/bruno-app/src/components/AiChatSidebar
Collections and data
- Collection watcher
packages/bruno-electron/src/app/collection-watcher.js - Collection formats
packages/bruno-filestore/src/workers/worker-script.ts - Collection I/O
packages/bruno-io/src/writeCollection/index.ts - Collection converters
packages/bruno-converters/src/openapi/openapi-to-bruno.js
Request execution
- Request preparation
packages/bruno-electron/src/ipc/network - HTTP request runtime
packages/bruno-requests/src - gRPC handlers
packages/bruno-electron/src/ipc/network/grpc-event-handlers.js - gRPC client
packages/bruno-requests/src/grpc/grpc-client.js - WebSocket handlers
packages/bruno-electron/src/ipc/network/ws-event-handlers.js - WebSocket client
packages/bruno-requests/src/ws/ws-client.js - OAuth callback
packages/bruno-electron/src/utils/oauth2-protocol-handler.js
API tooling
- Mock server
packages/bruno-electron/src/app/mock-server/mock-response-routes.js - API documentation
packages/bruno-common/src/api-docs/index.ts
Automation
- Collection CLI
packages/bruno-cli/src/commands/run.js - Local version control
Other components
- API developer
Connections 20
- API developer → Desktop workspace: uses
- Desktop workspace → Request editor: edits requests
- Desktop workspace → Environment settings: configures environments
- Desktop workspace → Collection watcher: opens collections
- Collection watcher → Collection formats: parses files
packages/bruno-electron/src/app/collection-watcher.js - API developer → Collection CLI: runs collections
- Collection CLI → Collection watcher: loads collection
- Request editor → Request preparation: submits request
- Request preparation → HTTP request runtime: dispatches HTTP
- gRPC handlers → gRPC client: calls gRPC
packages/bruno-electron/src/ipc/network/grpc-event-handlers.js - WebSocket handlers → WebSocket client: calls WebSocket
packages/bruno-electron/src/ipc/network/ws-event-handlers.js - gRPC handlers → Request preparation: prepares request
packages/bruno-electron/src/ipc/network/grpc-event-handlers.js - WebSocket handlers → Request preparation: prepares request
packages/bruno-electron/src/ipc/network/ws-event-handlers.js - OAuth callback → API developer: returns authorization
- API developer → Collection converters: imports API definitions
- API developer → Mock server: uses mock APIs
- API developer → API documentation: explores API docs
- Collection I/O → Collection formats: writes collection
- API developer → Local version control: versions collections
- AI assistant → Desktop workspace: assists workflow