Cursor rule Cursor
The DuckDuckGo browser includes a comprehensive A/B/N experiment framework that enables data-driven feature testing across iOS and macOS platforms. This framework allows you to safely experiment with new ideas while maintaining control groups and measuring impact.
Cursor rule Cursor
Use the existing Pixel.fire pattern with structured event definitions.
Cursor rule Cursor
Example: See singleton-antipattern.swift.
Cursor rule Cursor
The DuckDuckGo browser has moved away from traditional AppDelegate-based lifecycle handling to a state machine architecture. While AppDelegate still exists, it has been significantly thinned out and now delegates responsibility to a structured state machine.
Cursor rule Cursor
Cursor rule "architecture" from duckduckgo/apple-browsers, covering duckduckgo browser architecture guidelines, overall architecture, architecture patterns, mvvm for swiftui views and coordinator pattern.
Cursor rule Cursor
DuckDuckGo browser development follows GitHub Flow, a streamlined branching strategy that maintains a single main branch with feature branches for development work.
Cursor rule Cursor
BrowserServicesKit is the core shared library providing essential browser functionality to both iOS and macOS DuckDuckGo applications. It ensures consistent behavior and code reuse across platforms while maintaining privacy as the primary focus.
Cursor rule Cursor
This style guide is based on the official iOS style guide and incorporates DuckDuckGo-specific patterns and requirements.
Cursor rule Cursor
The DuckDuckGo iOS design system is implemented through DesignResourcesKit (DRK), a shared Swift package that contains our design tokens, type styles, colors, and design system elements.
Cursor rule Cursor
Use these instructions when you need to.
Cursor rule Cursor
Guidelines for app-level documentation under macOS/DuckDuckGo/Documentation.docc/.
Cursor rule Cursor
How to organize DocC documentation between package and app level; the entry point for any task that creates or updates DocC articles.
Cursor rule Cursor
Core principles for organizing documentation by abstraction level and maintaining quality.
Cursor rule Cursor
DuckPlayer uses two primary UserScript components to bridge native iOS functionality with web content.
Cursor rule Cursor
DuckPlayer provides video playback within the app, separate from the web view-based player. The architecture separates concerns into distinct components using a presenter pattern, native UI views, and JavaScript integration for seamless video playback experiences.
Cursor rule Cursor
Interactive pattern for adding feature flags to iOS and/or macOS with proper configuration.
Cursor rule Cursor
Use enum-based feature flags with protocols for type safety.
Cursor rule Cursor
This is the DuckDuckGo browser for iOS and macOS, built with privacy-first principles, modern Swift patterns, and cross-platform architecture.
Cursor rule Cursor
Prevent accidental or unrequested import churn that causes build/lint issues and diffs unrelated to the task. Ensure SwiftUI is only imported where required (e.g., #Preview blocks) and avoid touching existing imports unless strictly necessary.
Cursor rule Cursor
Pattern for abstracting pixel and wide event instrumentation behind domain-specific protocols.
Cursor rule Cursor
ALWAYS use the centralized dependency provider for all service dependencies.
Cursor rule Cursor
This document provides a comprehensive overview of how content blocking has been implemented on iOS to protect user privacy and block tracking attempts. Our implementation uses a dual-approach strategy that combines the efficiency of WebKit's native content blocking with the flexibility of JavaScript-based protection.
Cursor rule Cursor
The DuckDuckGo browser apps for iOS and macOS leverage Apple's Unified Logging System for capturing telemetry and debugging information. This system enables efficient tracking of app behavior, issue diagnosis, and performance monitoring in a structured and privacy-conscious manner.
Cursor rule Cursor
Define a concrete pattern for removing .shared singletons in the macOS app by replacing them with app-owned instances and dependency injection. The AIChatPreferences and AboutPreferences refactors in AppDelegate are canonical examples.