Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/FALAK097/typesteps/llms.txt

Use this file to discover all available pages before exploring further.

TypeSteps helps you stay motivated by setting daily typing goals and celebrating when you achieve them. This guide covers goal setting, progress tracking, and milestone notifications.

​
Setting Your Daily Goal

​
From the Dashboard

  1. Open the TypeSteps dashboard
  2. Navigate to Settings or the Goals section
  3. Enter your target number of daily keystrokes
  4. Your goal is automatically saved
Goals are stored in UserDefaults with the key daily_goal. The app checks this value to track your progress throughout the day.
Choose a goal based on your typing activity:
  • Light users (casual typing): 5,000 - 10,000 keystrokes/day
  • Regular users (daily work): 15,000 - 25,000 keystrokes/day
  • Heavy users (developers, writers): 30,000 - 50,000 keystrokes/day
  • Power users (intensive coding/writing): 50,000+ keystrokes/day
  • Approximately 2,000-2,500 words
  • About 2-3 hours of active typing
  • Equivalent to writing 3-4 pages of code or documentation
  • Around 30-40 emails or messages

​
How Goals Work

TypeSteps tracks your progress in real-time. Here’s how the system works:

​
Progress Tracking

Every keystroke is counted and checked against your daily goal (StorageManager.swift:75-77): 
if minuteStats.count > 120 {
    let keys = minuteStats.keys.sorted().prefix(minuteStats.count - 120)
    for key in keys { minuteStats.removeValue(forKey: key) }
}

checkMilestones(count: dailyStats[dayString] ?? 0, day: dayString)
saveStats()
The app:
  1. Increments your count with each keystroke
  2. Updates daily, hourly, and per-minute statistics
  3. Checks if you’ve reached any milestones
  4. Saves progress automatically

​
Milestone Detection

TypeSteps checks for goal completion (StorageManager.swift:79-93): 
private func checkMilestones(count: Int, day: String) {
    let goal = UserDefaults.standard.integer(forKey: "daily_goal")
    guard goal > 0 else { return }
    
    let milestones = [1.0]  // 100% of goal
    var notified = UserDefaults.standard.dictionary(forKey: notifiedKey) as? [String: [Double]] ?? [:]
    var dayNotified = notified[day] ?? []
    
    for m in milestones {
        if Double(count) >= Double(goal) * m && !dayNotified.contains(m) {
            sendNotification()
            dayNotified.append(m)
        }
    }
    
    notified[day] = dayNotified
    UserDefaults.standard.set(notified, forKey: notifiedKey)
}
Key features:
  • Currently tracks 100% goal completion (milestones = [1.0])
  • Can be extended to support 50%, 75%, 150% milestones
  • Prevents duplicate notifications for the same day
  • Tracks which milestones you’ve achieved per day

​
Notifications

​
Goal Completion Notification

When you reach your daily goal, TypeSteps sends a notification (StorageManager.swift:95-102): 
private func sendNotification() {
    let content = UNMutableNotificationContent()
    content.title = "Goal Reached! 🎯"
    content.body = "Congratulations! You've reached your daily typing goal."
    content.sound = .default
    
    let request = UNNotificationRequest(identifier: UUID().uuidString, content: content, trigger: nil)
    UNUserNotificationCenter.current().add(request)
}

​
Notification Setup

TypeSteps requests notification permissions on launch (TypeStepsApp.swift:6-9): 
func applicationDidFinishLaunching(_ notification: Notification) {
    NSApp.setActivationPolicy(.regular)
    UNUserNotificationCenter.current().requestAuthorization(options: [.alert, .sound]) { _, _ in }
    // ...
}
Make sure notifications are enabled in System Settings > Notifications > TypeSteps for goal alerts to work.

​
Viewing Your Progress

Quick progress view from the menu bar:
  • Today: Current keystroke count
  • This Week: Weekly total
  • This Month: Monthly total

​
Dashboard Insights

The dashboard provides detailed progress information:
  • Current count vs. goal percentage
  • Streak tracking: Days in a row you’ve met your goal
  • Best day: Your highest keystroke count ever
  • Productivity badges: Earned based on consistency

​
Productivity Badges

TypeSteps awards badges based on your performance (StorageManager.swift:194-201): 
func getProductivityBadge() -> (label: String, color: Color) {
    let streak = getCurrentStreak()
    let todayCount = getCount()
    
    if streak >= 30 { return ("UNSTOPPABLE", .red) }
    if streak >= 7 { return ("CONSISTENT", .orange) }
    if todayCount >= UserDefaults.standard.integer(forKey: "daily_goal") { 
        return ("GOAL GETTER", .green) 
    }
    return ("ON THE RISE", .blue)
}
Badges you can earn:
  • ON THE RISE (Blue): Default badge, you’re building momentum
  • GOAL GETTER (Green): Met today’s typing goal
  • CONSISTENT (Orange): 7+ day streak of meeting goals
  • UNSTOPPABLE (Red): 30+ day streak - elite status!

​
Streak Tracking

Your streak counts consecutive days where you’ve typed at least 1 keystroke (StorageManager.swift:305-322): 
func getCurrentStreak() -> Int {
    let calendar = Calendar.current
    var currentStreak = 0
    var checkDate = Date()
    
    while true {
        let key = dateFormatter.string(from: checkDate)
        if let count = dailyStats[key], count > 0 {
            currentStreak += 1
            guard let nextDate = calendar.date(byAdding: .day, value: -1, to: checkDate) else { break }
            checkDate = nextDate
        } else {
            if calendar.isDateInToday(checkDate) {
                guard let nextDate = calendar.date(byAdding: .day, value: -1, to: checkDate) else { break }
                checkDate = nextDate
                continue
            }
            break
        }
    }
    return currentStreak
}
Streak features:
  • Counts backward from today to find consecutive active days
  • Allows today to be “in progress” (doesn’t break streak if today has 0 yet)
  • Powers productivity badge calculations
  • Displayed prominently in dashboard

​
Goal Strategies

​
Progressive Goals

1

Start Conservative

Set a goal you can easily achieve for the first week (e.g., 5,000 keystrokes)
2

Analyze Your Baseline

Review your actual daily averages after a week
3

Increase Gradually

Raise your goal by 10-20% each week until you find your sustainable target
4

Maintain Consistency

Once you find a good goal, focus on maintaining streaks rather than constantly increasing

​
Work-Life Balance

Consider setting different goals for weekdays vs. weekends. You can manually adjust your goal in settings to match your expected activity level.

​
Advanced Goal Ideas

While TypeSteps currently supports daily goals, you could extend the system:
Track total keystrokes across a week rather than daily. Good for people with variable schedules.
Set goals per project (TypeSteps already tracks projects via window titles).
Set goals for specific app categories (Code, Writing, Communication) - data is already tracked.
Add 50%, 75%, 125%, 150% milestones by modifying the milestones array in checkMilestones():
let milestones = [0.5, 0.75, 1.0, 1.25, 1.5]

​
Next Steps

Data Management

Backup your goal data and statistics

WakaTime Integration

Compare typing goals with coding time

Build docs developers (and LLMs) love

Get started for freeTalk to us