BogoFlow User Guide
Everything you need to know to manage fiber node installations with BogoFlow. From creating your first program to cutting over nodes, this guide covers the full workflow.
Getting Started
BogoFlow organizes your work into a simple hierarchy: Organization → Programs → Nodes. Each node represents a physical location where fiber is being installed, and moves through 8 lifecycle stages from initial survey to completion.
Creating Your Account
Register
Visit app.bogoflow.io/register and create your account. You can either create a new organization or join an existing one.
Verify Your Email
After registering, you'll receive a verification email. Click the link to verify your email address — this is required before you can access the dashboard. The link expires in 24 hours, but you can request a new one from the verification page.
Create or Join an Organization
If you're starting fresh, create a new organization and give it a name and slug (short URL-friendly name). If your team already uses BogoFlow, ask your admin to send you an invitation link, or request to join by entering the organization's slug.
Set Up Your First Program
Once you're in your organization, navigate to Programs and click New Program. A program groups related nodes together — typically by project, region, or client.
Programs
Programs are the top-level container for organizing your work. Each program represents a project, contract, or deployment area and contains nodes, work orders, and documents.
Managing Programs
- Create a program from the Programs page with a name, client, region, and description.
- Click any program card to open its detail page with tabs for Nodes, Work Orders, and Documents.
- Edit a program by clicking the Edit button on its detail page to update name, client, region, or status.
- Status can be set to Active, Inactive, or Completed to reflect the program's lifecycle.
Nodes & Stages
Nodes are the core of BogoFlow. Each node represents a fiber installation site and progresses through 8 stages. The current stage is always visible and color-coded throughout the app.
The 8 Lifecycle Stages
Field Walkout
Initial site survey and assessment. Field techs visit the location and document existing conditions.
Design
Engineering creates network designs, calculates material requirements, and plans the build.
Permit
Submit applications to municipalities and utilities. Track approvals and compliance documents.
Construction
Physical build-out: trenching, conduit placement, pedestal installation, and infrastructure work.
Splicing
Fiber splicing, termination, and connector installation at splice points and enclosures.
Testing
OTDR testing, power level verification, and quality checks on all fiber paths.
Cutover
Transition subscribers to the new fiber network. Coordinate with headend and field teams.
Complete
Node is live and serving customers. All documentation finalized and archived.
Working with Nodes
Create a Node
From the Nodes page, click New Node. Select a program, enter the node ID (e.g., N-12345), name, address, and an optional due date. The node starts in the Field Walkout stage.
View Node Details
Click any node row to open its detail page. Here you can see all information, related work orders, documents, and the full stage history.
Change Stage
On the node detail page, use the Change Stage section to advance (or move back) the node to a new stage. Optionally provide a reason — this is recorded in the stage history.
Edit Node Details
Click Edit to update the node ID, name, address, coordinates, home/MDU counts, and due date. Nodes with due dates appear on the Calendar page and the dashboard's Upcoming Due Dates widget.
Work Orders
Work orders track specific tasks that need to be performed at a node — installations, repairs, splicing, testing, and more. Each work order has a status, priority, and can be assigned to a team member.
Work Order Lifecycle
Creating & Managing Work Orders
Create a Work Order
Click New Work Order, select a node, choose the work type (installation, repair, splicing, etc.), set priority and an optional due date, and give it a title and description.
Assign to a Team Member
On the work order detail page, use the Assignment section to pick a team member and set a due date. When someone is assigned, the status automatically changes from Pending to Assigned. Overdue items are highlighted in red.
Track Progress
The assigned tech can start work (moves to In Progress) and mark it complete. Use the Update Status section on the detail page to change status with optional notes.
QC Approval
Once work is completed, a QC inspector or manager can approve or reject from the QC section that appears on the detail page. Rejected work orders can be sent back for rework.
Documents
BogoFlow provides full document management with direct uploads, versioning, assignments, and an approval workflow. Documents are always linked to a node for easy organization.
Document Types
Working with Documents
Upload a Document
Click Upload Document, select a node and document type, choose your file, and give it a name. The file uploads directly to secure cloud storage.
Assign for Review
On the document detail page, use the Assignment section to assign the document to a team member and optionally set a due date for review or action.
Approve or Reject
Documents in Pending Review status show an approval section. Managers and QC inspectors can approve or reject with optional notes.
Upload New Versions
Need to update a document? On the detail page, click Upload New Version in the Version History section. Add change notes to explain what changed. All previous versions are preserved.
Calendar & Due Dates
The Calendar page gives you a unified view of all upcoming deadlines across nodes, work orders, and documents. Set due dates when creating or assigning work, and use the calendar to stay on top of what's coming up.
Setting Due Dates
On Nodes
When creating or editing a node, use the Due Date picker to set a target completion date. Nodes with due dates appear on the calendar alongside work orders and documents.
On Work Orders
When creating a work order, use the Due Date picker next to the priority field. You can also set or change the due date from the Assignment section on the work order detail page.
On Documents
On any document's detail page, the Assignment section includes a due date picker alongside the assignee dropdown. Set a deadline for review or completion.
Using the Calendar
Open the Calendar
Click Calendar in the sidebar navigation (directly below Dashboard). You'll see a month view on the left and an events list on the right.
Browse and Filter
Days with due items are highlighted on the calendar. Click a date to filter the events list to just that day. Use the month navigation arrows to move between months. Click Show all dates to reset the filter.
Navigate to Details
Click any event in the list to go directly to the node, work order, or document detail page. Overdue items are highlighted in red.
Team Management
BogoFlow supports multi-user organizations with invitation and join request flows. Organization admins manage team membership from the Users page in the dashboard.
Adding Team Members
Send an Invitation
Go to Users in the sidebar, click Invite User, enter their email, and select a role. They'll receive an email with a link to create their account and join your organization.
Handle Join Requests
Team members can also request to join your organization by entering your org slug during registration. You'll see pending requests on the Users page and can approve or deny them.
Manage Members
From the Users page, you can update roles, deactivate accounts, or remove members from the organization.
Roles & Permissions
BogoFlow uses role-based access control to ensure the right people have the right permissions.
| Role | Permissions |
|---|---|
| Admin | Full access — create/edit/delete everything, manage users and organization settings |
| Manager | Create and edit programs, nodes, work orders, and documents. Approve documents. |
| Field Tech | Update assigned work orders, upload documents, and view node information |
| QC Inspector | Approve or reject work orders and documents during quality control review |
| Viewer | Read-only access to all data within the organization |
Contractors
Contractors are external companies you issue construction or upgrade work to. Configure their contact info once, then select them from a dropdown when issuing work.
Add a Contractor
Go to the Contractors page in the sidebar and click Add Contractor. Enter their name, company, email, and phone number.
Invite as User (Optional)
From the contractor detail page, click Invite as User to send them a BogoFlow invitation. They'll get viewer access by default — you can choose a different role when inviting.
Issue Work to a Contractor
On a node detail page, use the Issued to Construction or Issued to Upgrade dropdown to assign a contractor. For medium/large MDUs, this is per-address. For small MDUs, span, and ped replacements, it's per-node. The contractor receives an email with the design PDF.
Ready to get started?
Create your free account and start managing your fiber installations today.
Get Started Free