Vision

The Vision() function defines your company's long-term direction with measurable success indicators.

Basic Usage

import { Vision } from 'business-as-code'

const vision = Vision({
  statement: "To become the world's most trusted widget platform",
  timeframe: '5 years',
  successIndicators: [
    '10M+ active users',
    'Present in 50+ countries',
    'Industry-leading NPS score',
    '$1B+ annual revenue',
  ],
})

Tracking Progress

checkIndicator

Check if a specific indicator has been achieved:

import { checkIndicator } from 'business-as-code'

const achieved = checkIndicator(vision, '10M+ active users', {
  activeUsers: 12000000,
})
// true

calculateProgress

Calculate overall vision progress:

import { calculateProgress } from 'business-as-code'

const progress = calculateProgress(vision, {
  activeUsers: 5000000,
  countries: 30,
  nps: 65,
  revenue: 500000000,
})
// { overall: 50, indicators: { ... } }

Validation

import { validateVision } from 'business-as-code'

const errors = validateVision(vision)
if (errors.length > 0) {
  console.error('Invalid vision:', errors)
}

Best Practices

Be Specific: Include measurable outcomes
Set Timeframes: Define when you expect to achieve the vision
Track Progress: Use success indicators to measure advancement
Review Regularly: Update as market conditions change

Type Definition

interface VisionDefinition {
  statement: string
  timeframe?: string
  successIndicators?: string[]
  metadata?: Record<string, unknown>
}

Was this page helpful?

Vision

On this page