Skip to main content

​
Feature Guide: Routing Management System

​
1. Overview

The Routing Management System forms the navigation backbone of Fiftyknots, mapping over 200 pages and 800+ API endpoints across your venture building journey. This system ensures you land on the right page at the right time - whether you’re reviewing a brief, checking your Data Room, or managing your venture squad. It powers intelligent navigation suggestions, tracks your activity patterns, and connects every feature into a cohesive platform experience that adapts to your current stage and role.

​
2. Step-by-Step Guide

​
Accessing Core Platform Pages

  1. Navigate to any primary workflow - The system automatically routes you based on your current job context. For example, /aistudio takes you to AI-powered brief generation, while /dataroomlist shows your document repositories.
  2. Use intelligent navigation suggestions - The platform tracks your activity and surfaces relevant next steps. Click suggested pages to jump directly to high-priority tasks or frequently accessed features.
  3. Switch between role-specific dashboards - Access your founder dashboard at /dashboard, expert workspace at /expertdashboard, or Sherpa control center at /sherpadashboard. The routing system maintains your context across role switches.
  4. Follow journey-based workflows - The system guides you through sequential stages. After completing ICP selection at /icpselection, you’ll route to /icptesting for validation, then to /journeyoverview for execution tracking.
  5. Access specialized tools - Navigate to feature-specific pages like /playbookide for playbook development, /prdashboard for product requirements, or /cvpvalidationdashboard for customer validation campaigns.
  6. Review legal and compliance pages - Access terms, privacy policy, and data deletion options through the /legal namespace - essential checkpoints as your venture scales.

​
Working with API Integrations

  1. Connect external services - Route to integration pages like /admin/xeroconnection for accounting sync or use the developer analytics endpoints to track platform usage and performance.
  2. Monitor system health - Access analytics dashboards at /analyticsdashboard and /telemetrydashboard to track feature adoption, error rates, and platform performance across your venture portfolio.

​
3. Common Questions

Q: How does the routing system know which page to show me next? The system analyzes your current job stage, role permissions, and recent activity patterns. It uses this context to surface relevant pages through navigation suggestions (accessible via /api/v1/navigation/suggestions) and automatically redirects you to the next logical step in your workflow. Q: Can I bookmark specific pages or save frequently used routes? Yes. The routing system tracks your frequent pages automatically (via /api/v1/navigation/frequent-pages) and maintains your recent navigation history. You can directly bookmark any page URL - the system preserves your job context across sessions. Q: What happens if I try to access a page before completing prerequisite steps? The system enforces feature access gates based on your venture stage and journey progress. If you attempt premature access, you’ll route to an appropriate intermediate step. For example, accessing /confidencereport before generating an assessment redirects you to complete the required confidence evaluation first. Q: How do I switch between different jobs or ventures I’m working on? Navigate to your portfolio overview at /intake/portfolio or use the job selector in your main dashboard. The routing system maintains separate contexts for each job, ensuring URLs like /brief/:jobId/briefs always load the correct venture’s data. Q: Can I share specific page URLs with my Sherpa or team members? Yes. Most workflow pages support direct URL sharing with embedded job identifiers. Team members with appropriate permissions can access shared routes. For sensitive data like Data Rooms, use the invitation system at /inviteredemption rather than direct URL sharing.

​
4. Troubleshooting

Issue: Page loads but shows “Access Denied” or redirects unexpectedly The routing system enforces role-based permissions and stage gates. Verify your profile completion at /profile and confirm your current lifecycle position at /lifecycle/position. If working on a team project, check your invitation status at /team-member/invitations. Issue: Navigation suggestions show outdated or irrelevant pages The system learns from your activity patterns over time. Clear stale suggestions by dismissing them at /api/v1/navigation/suggestions/:suggestionId/dismiss. The algorithm recalibrates based on your recent actions and current job stage. Force a refresh by completing a major milestone or advancing your journey stage. Issue: Deep links from emails or external sources don’t work Verify your authentication session at /api/v1/auth/session. The routing system requires valid credentials for most pages. If you’re accessing from a new device or after session expiration, route through /login first, then navigate to your target page. For public upload links, use the tokenized URLs at /publicupload which bypass authentication. Issue: Can’t find a specific feature or page mentioned in documentation Use the navigation search at /api/v1/navigation/search to locate features by name or keyword. The routing system indexes all accessible pages and provides direct links with your current job context. If search returns no results, the feature may require higher permissions or a different venture stage - check your journey position and feature access status. Navigation Tracking and Activity Monitoring - The system logs your page visits and interaction patterns through /api/v1/navigation/track-activity, powering personalized routing suggestions and workflow optimization. This connects to your lifecycle progression by identifying bottlenecks and frequently abandoned workflows. Journey Management and Stage Progression - Your routing experience adapts as you advance through venture stages. The Journey Builder at /admin/journeybuilder defines available routes per stage, while your personal journey at /journeyoverview shows your current position and unlocks new pages as you progress. Access Override and Permission Management - Administrators can grant temporary access to restricted routes via /admin/accessoverridemanagement. This connects to the routing system by allowing founders to preview upcoming features or access specialized tools before meeting standard graduation criteria.