Peregrine

Documentation specific to Project Peregrine (Internal Only).
Categories:

This section contains documentation for Project Peregrine. Access is restricted.

Overview

Project Peregrine is the internal development of The Phenom App - a React Native mobile application for phenomenon documentation and verification. Built with modern web technologies and cross-platform mobile development practices, the project focuses on creating an intuitive platform that captures, authenticates, and analyzes real-world phenomena through advanced geospatial mapping and sensor integration.

Technology Stack

Core Framework

  • Framework: React Native 0.81.5 with React 19.1.0
  • Runtime/Platform: Expo 54.0.31
  • Language: TypeScript 5.9.2 (strict mode)
  • Navigation: React Navigation 7.x

Specialized Libraries

  • Geospatial Mapping: Mapbox GL (10.2.10) with H3 hexagonal geospatial indexing
  • Storage: MMKV for encrypted local storage
  • Internationalization: i18next (7 languages)
  • Boilerplate Foundation: Ignite framework

Cross-Platform Development

This approach enables unified development targeting both iOS and Android from a single codebase. TypeScript strict mode ensures type safety across the entire application.

Key Features

Project-Specific (Custom) Features

These features are unique to Peregrine and distinguish it from standard boilerplate applications:

  • H3 Hexagonal Map System - Global map with hexagonal tessellation overlay for spatial data organization
  • EndlessMediaFeed Component - Custom infinite scroll component for browsing phenomena media
  • Domain Models - Specialized data structures (PhenomCoords, PhenomCategory, PhenomItem, PhenomProfile)
  • API Adapter Pattern - Pluggable backend architecture for future integrations
  • Multi-Language Support - 7 language translations via i18next

Phenomenon Categories

The app organizes content into specialized categories:

  • Electromagnetic phenomena
  • Infrasound events
  • Unidentified Aerial Phenomena (UAP)
  • Paranormal activity
  • Cryptid sightings

See Features Overview for detailed feature documentation.

Project Architecture

The application is built on a modular architecture with clear separation of concerns:

  • Components Layer - Reusable UI components with custom Phenom-specific components
  • Screens Layer - Application screens organized by feature
  • Services Layer - API adapters and data services
  • Theme Layer - Centralized design tokens and styling
  • Internationalization - Language and localization management

See Architecture Deep Dive for comprehensive technical architecture documentation.

Development Resources

Code Repositories

Technical Documentation

Project Objectives

Development Goals (2025)

Q3 2025 Targets:

  • Establish fully automated CI/CD pipeline for iOS and Android builds
  • Reduce deployment time from code merge to TestFlight/Google Play to under 45 minutes
  • Implement EAS (Expo Application Services) integration with GitHub Actions

Q4 2025 Targets:

  • Achieve >80% unit test coverage for core application logic
  • Complete state management, API interactions, and utility testing
  • Establish automated testing in CI pipeline

Development Areas

Explore specific development aspects in the subsections below:

Deployment & Release

Team & Process

Architecture Overview

Technical architecture, design patterns, and system design of the Peregrine mobile application.

Product Requirements Document (PRD)

High-level product requirements for the Peregrine version of the Phenom app.

Features Overview

Custom Peregrine features, capabilities, and implementations.

Product Roadmap

Full-feature production launch roadmap for PhenomApp Peregrine version with ALL features (except AR modes) delivered by March 15, 2026. Includes C2PA signing, 3D globe, heatmaps, gamification, teams, desktop website, and 3rd party integrations. Sprint timeline with parallel development.

Backend Integration & Infrastructure

Backend API, database, infrastructure, and integration points for Peregrine mobile app.

External Resources & References

External documentation and resources for C2PA content authenticity and Matrix/Synapse messaging integration.

Sensor Usage

Overview of device sensors utilized via Expo APIs.

EAS Deployment Pipeline

Comprehensive guide to the Expo Application Services (EAS) mobile deployment pipeline for iOS and Android production builds and submission.

iOS TestFlight Testing (EAS)

Using TestFlight and EAS for testing iOS feature branches.

Research Analysis & Strategy Validation

Summary of research findings from user interviews and surveys, validating the core design strategy and identifying critical gaps for the Phenom App.

Team Meeting Notes

Agendas, notes, and action items from Peregrine project team meetings.

Finding Device UDIDs

Instructions for finding iOS and Android device UDIDs for internal testing builds.

EAS Feature Branch Builds

How to create and distribute internal test builds for feature branches using EAS Build.

Testing Roles & Responsibilities

Assignment of testing responsibilities for Project Peregrine and Project Buzzard features.