native-update 1.4.8 → 2.0.0

package/docs/project-knowledge-base/README.md

@@ -0,0 +1,90 @@
+# Native Update AI Knowledge Base
+
+## Metadata
+
+- **Project:** Native Update
+- **Knowledge Base Purpose:** High-context reference set for AI tools, planning, development, QA, legal review, content generation, and portfolio/social reuse
+- **Coverage Goal:** Provide a practical, current map of the product, codebase, docs corpus, routes, forms, users, modules, integrations, and operating assumptions
+- **Reference Date:** 2026-03-16
+- **Last Updated:** 2026-03-16
+- **Update Cadence:** Every 2 weeks minimum while the project is active, plus any time major product or docs changes land
+- **History Policy:** Keep update history in this file and keep only the latest 10 entries
+
+## Folder Purpose
+
+This folder is the canonical high-context AI reference set for the Native Update project. It is meant to answer questions like:
+
+- What does the product do?
+- What features exist now?
+- Which users exist?
+- Which pages, routes, and forms are present?
+- Which services, stores, modules, and native layers exist?
+- What is the recommended backend and data model?
+- Which docs already exist in `/docs` and what do they cover?
+- What legal, marketing, testing, and planning context is already documented?
+
+This folder is intentionally different from the public docs. Public docs explain usage. This knowledge base explains the whole project to an AI system or future collaborator.
+
+## File Map
+
+- `01-system-overview.md`  
+  Product scope, capabilities, platform coverage, user types, URLs, and decision context.
+
+- `02-routes-pages-forms-users.md`  
+  Website routes, dashboard/admin routes, page purposes, major interactions, forms, and access rules.
+
+- `03-tech-stack-modules-services.md`  
+  Repo architecture, package structure, frontend services, stores, plugin modules, CLI commands, native modules, and backend components.
+
+- `04-data-models-integrations.md`  
+  Firestore schema, document purposes, authentication model, Google Drive flow, manifest publishing flow, and system boundaries.
+
+- `05-docs-corpus-inventory.md`  
+  Full inventory of the current `/docs` folder, grouped and described so AI can understand what knowledge already exists.
+
+- `06-operations-testing-legal-content.md`  
+  Testing posture, production/release considerations, legal pages, SEO/content context, and known constraints for planning or messaging.
+
+## Primary Project URLs
+
+- Marketing website: `https://nativeupdate.aoneahsan.com`
+- Docs entry: `https://nativeupdate.aoneahsan.com/docs`
+- Contact page: `https://nativeupdate.aoneahsan.com/contact`
+- NPM package page: `https://www.npmjs.com/package/native-update`
+
+## High-Level Product Definition
+
+Native Update is an open-source Capacitor update platform. It combines:
+
+- OTA/live updates for web assets
+- native app update handling
+- in-app review prompting
+- background update checks
+- release manifests and rollout control
+- security validation and signing support
+- a web dashboard for app/build management
+- example backends and example apps
+- CLI tooling for release workflows
+
+## Recommended Use Of This Folder
+
+- Use this folder as the first-stop AI context before generating plans, code proposals, QA checklists, legal summaries, portfolio content, SEO drafts, social content, or roadmap suggestions.
+- Use the public `/docs` folder when exact implementation or end-user guidance is needed.
+- If any detail in this folder and the source code conflict, the source code is the stronger authority and this folder should be updated.
+
+## Update Checklist
+
+- Re-check all routes in `website/src/router.tsx`
+- Re-check user/auth/admin assumptions in auth context and route guards
+- Re-check forms and fields on dashboard pages
+- Re-check package versions and tech stack
+- Re-check Firestore types and backend assumptions
+- Re-check `/docs` inventory for added/removed files
+- Re-check any new `CLAUDE.md` files in nested subprojects
+- Update `Reference Date`, `Last Updated`, and `Update History`
+
+## Update History
+
+| Date | Summary |
+|------|---------|
+| 2026-03-16 | Initial AI knowledge-base folder created with project-wide coverage across product, routes, forms, modules, data models, docs corpus, and operations context. |

package/docs/project-profiles/native-update-capacitor-update-platform-project-profile-last-updated-2026-03-16.md

@@ -0,0 +1,454 @@
+# Native Update - Capacitor Update Platform Project Profile
+
+## Document Metadata
+
+- **Project Name:** Native Update
+- **Project Type:** Open-source Capacitor plugin + update management platform
+- **Primary Domain:** Mobile app infrastructure / developer tooling / OTA delivery
+- **Owner / Creator:** Ahsan Mahmood
+- **Primary Contact:** aoneahsan@gmail.com
+- **Package Name:** `native-update`
+- **Current Package Version Reference:** `1.4.9`
+- **License:** MIT
+- **Primary Website:** `https://nativeupdate.aoneahsan.com`
+- **Reference Date:** 2026-03-16
+- **Last Updated:** 2026-03-16
+- **Filename Rule:** Always keep `last-updated-YYYY-MM-DD` in the filename
+- **Status Reference:** This profile reflects the repository state visible on 2026-03-16 from source code, docs, package metadata, tests, website pages, and example apps. Some older docs in the repo describe earlier pre-production stages.
+
+## Executive Summary
+
+Native Update is a full update-management solution for Capacitor apps that combines over-the-air web asset updates, native app store update flows, in-app review prompts, background update checks, security tooling, developer CLI utilities, example backends, and a web dashboard into one ecosystem. The project is designed to help developers ship fixes faster, reduce release friction, improve app quality, and maintain tighter control over the mobile update lifecycle across Android and iOS.
+
+This project is not just a plugin. It is positioned as a complete developer platform around update delivery, release management, rollout control, verification, and user engagement for hybrid mobile apps built with Capacitor.
+
+## Short Positioning Lines
+
+### One-Line Version
+
+Native Update is an open-source Capacitor update platform that unifies OTA updates, app store updates, in-app reviews, background checks, security verification, and release management in one package.
+
+### Two-Line Version
+
+Native Update helps Capacitor developers ship JavaScript, HTML, and CSS fixes instantly, manage native store updates intelligently, and improve ratings through in-app review flows. It combines plugin infrastructure, security tooling, CLI automation, example backends, and a management dashboard into one developer-friendly system.
+
+### Resume / CV Summary
+
+Built **Native Update**, an open-source Capacitor update platform that streamlines OTA delivery, native app updates, in-app review prompts, secure bundle signing, rollout management, and dashboard-based release operations for hybrid mobile apps.
+
+## Resume-Ready Achievement Bullets
+
+- Built an open-source Capacitor update platform that combines OTA updates, app store update flows, and in-app reviews in a single developer-focused package.
+- Implemented cross-platform native support with Swift for iOS and Kotlin for Android, backed by TypeScript APIs for Capacitor apps.
+- Designed secure update delivery with checksum validation, signature verification, HTTPS enforcement, certificate pinning support, and bundle integrity controls.
+- Created a full release workflow including CLI tooling for bundle creation, signing, verification, key generation, backend scaffolding, local server startup, and deployment monitoring.
+- Developed a companion dashboard and marketing site for app management, build uploads, rollout control, analytics visibility, and configuration generation.
+- Added example implementations for React + Capacitor, Node.js + Express, and Firebase-based backend flows to reduce adoption friction.
+- Structured the system for production-oriented release operations with channels, staged rollouts, rollback support, background update checks, and multiple update strategies.
+- Wrote extensive documentation covering installation, APIs, migration, security, deployment, troubleshooting, and end-to-end usage.
+- Built automated coverage across TypeScript, iOS, Android, and end-to-end testing layers to validate update lifecycle flows and failure scenarios.
+- Positioned the product as an open-source alternative for teams that want more control, transparency, and flexibility in mobile update infrastructure.
+
+## Portfolio Website Description
+
+Native Update is a developer infrastructure product I built for Capacitor applications. It solves one of the biggest operational challenges in hybrid mobile apps: shipping updates safely, quickly, and with less dependency on slow release cycles. The platform combines OTA updates for web assets, native app update guidance, in-app review requests, background update scheduling, release channels, rollback support, security validation, CLI tooling, and a web dashboard. It is designed for teams that want a modern, open-source, security-conscious update workflow across iOS and Android.
+
+## LinkedIn Profile Description
+
+Creator of **Native Update**, an open-source Capacitor update platform for OTA delivery, native app store updates, in-app reviews, secure bundle signing, rollout control, analytics-ready release workflows, and dashboard-driven update management.
+
+## Vision
+
+To make modern mobile update infrastructure accessible, open, secure, and practical for every Capacitor developer, from solo builders to growing product teams.
+
+## Mission
+
+To remove the operational complexity of shipping updates across hybrid mobile apps by providing one unified system for update delivery, release control, app version guidance, review collection, and developer tooling.
+
+## Problem It Solves
+
+Capacitor developers often face a fragmented update workflow:
+
+- OTA updates may require custom infrastructure or expensive third-party services.
+- Native app store updates are handled separately from web asset updates.
+- Review prompts are often implemented as one-off logic without reusable strategy.
+- Security around bundle delivery, signatures, and validation is easy to get wrong.
+- Release teams need rollout control, channels, rollback logic, and visibility into the update process.
+
+Native Update solves this by bringing these concerns into one coordinated product.
+
+## Core Product Value
+
+Native Update delivers value at multiple levels:
+
+- **Speed:** Faster bug fixes and content changes through OTA delivery.
+- **Control:** Better release discipline with channels, staged rollout concepts, and rollback support.
+- **Security:** Stronger trust with signing, checksums, HTTPS enforcement, and validation layers.
+- **Experience:** Smoother app update prompts and in-app review flows.
+- **Productivity:** CLI tools, examples, docs, and a dashboard reduce implementation overhead.
+- **Ownership:** Open-source approach and self-controlled infrastructure options reduce platform lock-in.
+
+## What The Project Includes
+
+### 1. OTA / Live Updates
+
+- JavaScript, HTML, and CSS update delivery
+- Multiple update strategies: immediate, background, manual
+- Delta update support
+- Version management
+- Automatic rollback patterns
+- Update channels such as development, staging, and production
+- Progress tracking and event listeners
+
+### 2. Native App Updates
+
+- App version check flows
+- Immediate and flexible update modes
+- Store-aware logic for Android and iOS
+- Direct app store navigation support
+- Version priority and minimum-version handling
+
+### 3. In-App Reviews
+
+- Native review prompt integration
+- Smart timing concepts
+- Rate limiting
+- Platform-specific review handling for iOS and Android
+- Fallback handling for web environments
+
+### 4. Background Updates
+
+- Background update checks
+- Native notification support
+- Battery-aware scheduling controls
+- Cross-platform background update architecture
+
+### 5. Security Tooling
+
+- Bundle signing workflow
+- Public/private key generation
+- Checksum validation
+- Signature verification
+- Certificate pinning support
+- HTTPS-only security posture
+
+### 6. Developer Tooling
+
+- CLI commands for initialization and release workflows
+- Included command surface such as `init`, `bundle-create`, `bundle-sign`, `bundle-verify`, `keys-generate`, `backend-create`, `server-start`, and `monitor`
+- Bundle creation utilities
+- Bundle verification tooling
+- Local server tooling
+- Monitoring command support
+
+### 7. Dashboard and Platform Layer
+
+- App management
+- Build upload flows
+- Channel configuration
+- Rollout control
+- Analytics-oriented management layer
+- Google Drive integration
+- Configuration generation for easier setup
+
+### 8. Documentation and Examples
+
+- Installation and quick-start guides
+- API references
+- Security and deployment guides
+- Migration documentation
+- Troubleshooting material
+- Example apps and backend templates
+
+## Technical Highlights
+
+- **Frontend / Platform:** Capacitor, TypeScript, web-compatible plugin layer
+- **Native iOS:** Swift
+- **Native Android:** Kotlin
+- **CLI / Tooling:** Node.js-based command-line utilities
+- **Dashboard Website:** React, Vite, TypeScript, Firebase, Google integration
+- **Testing:** Vitest, XCTest, JUnit/Kotlin tests, end-to-end test coverage
+- **Architecture Style:** Modular plugin system with feature-specific domains for live updates, app updates, reviews, background tasks, security, and Firestore-backed manifests
+
+## Architecture Strengths
+
+- Clear separation between live update logic, app update logic, review logic, background scheduling, and security layers
+- Support for both plugin consumers and platform operators
+- Strong documentation footprint for onboarding and maintenance
+- Practical delivery model with example backends and example apps
+- Designed for real release workflows instead of only simple code demos
+
+## Proof Points Visible In The Repository
+
+- Native iOS and Android implementation directories are present and populated
+- A CLI package exists with multiple release-oriented commands
+- The repo contains website/dashboard pages, admin views, and dashboard views
+- Example apps exist for React + Capacitor, Node + Express, and Firebase
+- Feature docs, API docs, security docs, migration docs, and testing docs are present
+- Source tree includes modules for live updates, app updates, app reviews, background updates, core infrastructure, security, and Firestore integration
+- The repository includes automated tests across TypeScript, iOS, Android, and E2E flows
+
+## Why This Project Stands Out
+
+- It treats updates as a platform problem, not just a plugin method call.
+- It combines product, infrastructure, security, and developer experience in one repo.
+- It supports both immediate developer adoption and future platform expansion.
+- It is open-source, which increases trust, inspectability, and adaptability.
+- It is especially relevant for hybrid app teams that need fast iteration without losing control over release quality.
+
+## Underrated / Hidden Strengths
+
+- The project is usable as both a package and a portfolio-grade product ecosystem.
+- The presence of example backends lowers the barrier to real-world adoption.
+- The dashboard direction makes the project stronger than a typical library-only release.
+- Security tooling is built into the story, which improves credibility with serious teams.
+- The combination of update delivery and review prompting ties technical operations to growth outcomes.
+- The project creates multiple content angles: engineering, DevTools, mobile delivery, open source, security, release management, and product growth.
+
+## Target Users
+
+- Capacitor developers
+- Hybrid mobile app teams
+- Startups shipping mobile products
+- Agencies building cross-platform apps for clients
+- Developers migrating from fragmented update workflows
+- Teams that want more control than closed managed services offer
+
+## Ideal Use Cases
+
+- Rapid bug-fix releases without full app store delay
+- Controlled staged rollouts across dev, staging, and production
+- Secure update delivery for mobile products
+- Managing both OTA and native version updates from one system
+- Improving app ratings with better-timed native review prompts
+- Giving product teams a dashboard for release operations
+
+## User Benefits
+
+- Faster delivery of fixes and improvements
+- Reduced user friction during app update flows
+- Better app stability through rollback-aware design
+- More confidence in update authenticity and bundle integrity
+- Easier setup through docs, examples, and CLI support
+- Better lifecycle control across development, testing, and production environments
+
+## Business Benefits
+
+- Reduced time-to-fix for production issues
+- Better release confidence and governance
+- Lower reliance on manual update handling
+- Improved retention potential through smoother app maintenance
+- Better app store growth potential through review-request tooling
+- Stronger technical credibility for teams using a secure, documented update workflow
+
+## Web, Mobile, and Platform Scope
+
+### Current Scope
+
+- **Mobile:** Strong core focus through Capacitor plugin support for Android and iOS
+- **Web:** Dashboard, docs website, and web fallback behavior
+- **CLI / DevTools:** Local developer tooling and release operations support
+
+### Future Expansion Potential
+
+- Multi-tenant SaaS management
+- Enterprise SSO
+- Advanced rollout strategies
+- A/B testing for update delivery
+- More framework examples and adapters
+- CI/CD templates and deeper automation
+- Larger self-service release operations platform
+
+## Best Angles To Market This Project
+
+- Open-source alternative in mobile update infrastructure
+- Full-stack product built from plugin layer to dashboard layer
+- Security-first OTA workflow for Capacitor
+- Developer tooling project with real operational value
+- Release-management system for hybrid apps
+- Productized engineering project with ecosystem thinking
+
+## Best Talking Points For Interviews, Portfolio, and Profiles
+
+- I built an end-to-end update management ecosystem rather than a single isolated feature.
+- I worked across TypeScript, Swift, Kotlin, CLI tooling, dashboards, docs, and release workflows.
+- I focused on both engineering depth and product usability.
+- I designed for real adoption by including examples, docs, tooling, and management interfaces.
+- I addressed both technical reliability and business outcomes like speed, user trust, and app growth.
+
+## Suggested Portfolio Tags
+
+- Capacitor
+- TypeScript
+- Swift
+- Kotlin
+- React
+- Vite
+- Firebase
+- Google Drive Integration
+- OTA Updates
+- Mobile DevTools
+- Open Source
+- Developer Platform
+- Mobile Infrastructure
+- Release Management
+- App Store Optimization
+
+## SEO Pack
+
+### Primary SEO Keywords
+
+- Capacitor OTA updates
+- Capacitor native update plugin
+- Capacitor app updates
+- Capacitor in-app review plugin
+- OTA update platform for Capacitor
+- hybrid app update management
+- mobile app release management
+- secure OTA updates for mobile apps
+- Capacitor rollout management
+- open source mobile update platform
+
+### Secondary SEO Keywords
+
+- Swift Kotlin Capacitor plugin
+- app store update workflow
+- bundle signing for mobile apps
+- checksum verification for app updates
+- certificate pinning update delivery
+- Capacitor developer tools
+- Capacitor dashboard
+- Firebase Google Drive update backend
+- mobile update CLI
+- CodePush alternative for Capacitor
+
+### Suggested SEO Title
+
+Native Update - Open-Source Capacitor OTA, App Update, and Review Platform
+
+### Suggested SEO Meta Description
+
+Native Update is an open-source Capacitor platform for OTA updates, app store update flows, in-app reviews, secure bundle delivery, rollout control, CLI tooling, and dashboard-based release management.
+
+### Suggested OG / Social Title
+
+Native Update: Complete Update Infrastructure for Capacitor Apps
+
+### Suggested OG / Social Description
+
+An open-source update platform for Capacitor apps with OTA delivery, native app updates, in-app reviews, security tooling, dashboard management, and developer-friendly release workflows.
+
+### Suggested URL Slug
+
+`native-update-capacitor-update-platform`
+
+## Social Content Hooks
+
+- Building a complete update platform for Capacitor instead of a single plugin
+- Why OTA updates need security, rollback logic, and release discipline
+- How Native Update combines app store updates and web asset updates in one system
+- Why open-source mobile infrastructure matters
+- The engineering challenge of unifying TypeScript, Swift, Kotlin, CLI, and dashboard workflows
+- How developer tools can directly improve product velocity
+- What makes Native Update a practical alternative to fragmented update stacks
+- Lessons from building docs, examples, and management tooling around one package
+
+## Content Themes For Future Posts
+
+- Product launch posts
+- feature breakdown posts
+- architecture deep dives
+- security-focused posts
+- open-source journey posts
+- developer experience posts
+- roadmap posts
+- behind-the-scenes build logs
+- dashboard showcase posts
+- migration and comparison posts
+
+## Social Proof / Credibility Points
+
+- Open-source MIT-licensed project
+- Cross-platform implementation
+- Dedicated website and dashboard presence
+- Example apps and backend templates
+- CLI tooling for real release workflows
+- Security-focused update verification story
+- Broad documentation coverage
+- Multi-layer testing strategy
+
+## 20 Recommended Hashtags
+
+#CapacitorJS
+#CapacitorPlugin
+#MobileDevelopment
+#AppUpdates
+#OTAUpdates
+#OpenSource
+#TypeScript
+#AndroidDevelopment
+#iOSDevelopment
+#SwiftLang
+#KotlinAndroid
+#HybridApps
+#DeveloperTools
+#SaaS
+#Firebase
+#ReleaseManagement
+#AppStoreOptimization
+#SoftwareEngineering
+#BuildInPublic
+#IndieHackers
+
+## Generic Hashtags Provided By Project Owner
+
+#Aoneahsan
+#AhsanMahmood
+#Zaions
+#BestOpenSourceCommunityProject
+#TopFree
+#SaaSApp
+
+## Recommended Hashtag Mix Strategy
+
+- Use 3 to 6 broad hashtags from the recommended list.
+- Add the 6 owner-branded hashtags when the post is personal-brand focused.
+- Rotate hashtags based on audience: developer, startup, mobile, open-source, or product-building.
+- Avoid stuffing all hashtags into every post; keep them relevant to the post angle.
+
+## Suggested Profile / Resume Headline Variants
+
+- Building Native Update, an open-source Capacitor update platform for OTA delivery, app updates, and in-app reviews
+- Creator of Native Update: secure OTA and release-management infrastructure for Capacitor apps
+- Full-stack engineer behind Native Update, a developer platform for hybrid mobile update workflows
+- Open-source builder creating update infrastructure, release tooling, and dashboard workflows for Capacitor teams
+
+## Suggested Project Categories
+
+- Developer Tools
+- Mobile Infrastructure
+- Open Source SaaS
+- Release Engineering
+- App Operations
+- Product Engineering
+
+## Suggested Cautions For Future Content
+
+- Do not present roadmap items as already shipped features.
+- If a post references current project status, verify it against the latest repo state first.
+- If metrics such as installs, users, stars, revenue, or active deployments are not verified, do not invent them.
+- When comparing to other tools, focus on positioning and architecture rather than unsupported superiority claims.
+
+## Weekly Maintenance Rule For This File
+
+- Update this file every week when the project is active.
+- Keep the filename date current.
+- Update the `Reference Date`, `Last Updated`, and `Update History`.
+- Keep only the latest 10 history entries in this file.
+- Revise positioning, shipped features, roadmap notes, and SEO metadata when the project changes.
+
+## Update History
+
+| Date | Summary |
+|------|---------|
+| 2026-03-16 | Initial detailed portfolio, resume, SEO, and social-content project profile created from repository review. |

package/docs/project-profiles/native-update-capacitor-update-platform-project-profile-last-updated-2026-03-24.md

@@ -0,0 +1,66 @@
+# Native Update - Capacitor Update Platform Project Profile
+
+## Document Metadata
+
+- **Project Name:** Native Update
+- **Project Type:** Open-source Capacitor plugin + update management platform
+- **Primary Domain:** Mobile app infrastructure / developer tooling / OTA delivery
+- **Owner / Creator:** Ahsan Mahmood
+- **Primary Contact:** aoneahsan@gmail.com
+- **Package Name:** `native-update`
+- **Current Package Version Reference:** `1.4.9`
+- **License:** MIT
+- **Primary Website:** `https://nativeupdate.aoneahsan.com`
+- **Reference Date:** 2026-03-24
+- **Last Updated:** 2026-03-24
+- **Filename Rule:** Always keep `last-updated-YYYY-MM-DD` in the filename
+- **Status Reference:** This profile reflects the repository state visible on 2026-03-24 from package metadata, source layout, docs, tests, dashboard docs, and example apps.
+
+## Verification Snapshot
+
+- **Tests:** `yarn test --run` passed with 81 tests
+- **Build:** `yarn build` passed
+- **Known Warning:** Node `DEP0169` deprecation warnings surfaced during Yarn/build execution
+
+## Executive Summary
+
+Native Update is a full update-management solution for Capacitor apps that combines over-the-air web asset updates, native app store update flows, in-app review prompts, background update checks, security tooling, CLI utilities, example backends, and a web dashboard into one ecosystem. The project is positioned as both a reusable plugin and a broader release-operations platform for hybrid mobile products.
+
+## Current Positioning
+
+Native Update helps Capacitor teams ship fixes faster, manage native store updates more intelligently, improve review prompting, and centralize release operations through a dashboard-driven workflow. It is stronger than a simple plugin because it includes the operational layer around updates, not just device APIs.
+
+## Core Product Value
+
+- **Speed:** OTA delivery for faster fixes and content changes
+- **Control:** Channels, rollout concepts, rollback support, and update strategy choices
+- **Security:** Signing, checksums, HTTPS posture, and validation tooling
+- **Productivity:** CLI tooling, docs, examples, and dashboard support
+- **Ownership:** Open-source and self-controlled infrastructure options
+
+## Proof Points In Current Repo State
+
+- Native Android and iOS implementations are present
+- CLI package is present
+- Example apps exist under `example-apps/`
+- Website/dashboard project exists under `website/`
+- Security, migration, production-readiness, and API docs are present
+- Current automated package verification passed on 2026-03-24
+
+## Resume / CV Summary
+
+Built **Native Update**, an open-source Capacitor update platform that unifies OTA delivery, native app updates, in-app reviews, signing and verification, release tooling, example backends, and dashboard-driven update operations for hybrid mobile apps.
+
+## Resume-Ready Achievement Bullets
+
+- Built an open-source Capacitor update platform combining OTA updates, app store update flows, and in-app reviews in one developer-facing package.
+- Implemented cross-platform native support alongside TypeScript APIs, CLI tooling, example backends, and a dashboard-oriented product layer.
+- Added security-focused update delivery features including checksum validation, signature verification, and release workflow tooling.
+- Structured the project around operational update management, not only plugin methods, with docs and examples for real adoption.
+
+## Update History
+
+| Date | Type | Notes |
+| --- | --- | --- |
+| 2026-03-24 | Refreshed | Updated metadata, verification snapshot, and repo-state summary to match current package state. |
+| 2026-03-16 | Previous | Prior project profile version. |

package/docs/project-profiles/native-update-capacitor-update-platform-project-profile-last-updated-2026-03-25.md

@@ -0,0 +1,67 @@
+# Native Update - Capacitor Update Platform Project Profile
+
+## Document Metadata
+
+- **Project Name:** Native Update
+- **Project Type:** Open-source Capacitor plugin + update management platform
+- **Primary Domain:** Mobile app infrastructure / developer tooling / OTA delivery
+- **Owner / Creator:** Ahsan Mahmood
+- **Primary Contact:** aoneahsan@gmail.com
+- **Package Name:** `native-update`
+- **Current Package Version Reference:** `1.4.9`
+- **License:** MIT
+- **Primary Website:** `https://nativeupdate.aoneahsan.com`
+- **Reference Date:** 2026-03-25
+- **Last Updated:** 2026-03-25
+- **Filename Rule:** Always keep `last-updated-YYYY-MM-DD` in the filename
+- **Status Reference:** This profile reflects the repository state visible on 2026-03-25 from package metadata, source layout, docs, tests, dashboard docs, and example apps.
+
+## Verification Snapshot
+
+- **Tests:** `yarn test:run` passed with 81 tests
+- **Build:** `yarn build` passed
+- **Remediation:** Root package manager standardized on Yarn-only commands, with npm and pnpm removed from the root package path
+
+## Executive Summary
+
+Native Update is a full update-management solution for Capacitor apps that combines over-the-air web asset updates, native app store update flows, in-app review prompts, background update checks, security tooling, CLI utilities, example backends, and a web dashboard into one ecosystem. The project is positioned as both a reusable plugin and a broader release-operations platform for hybrid mobile products.
+
+## Current Positioning
+
+Native Update helps Capacitor teams ship fixes faster, manage native store updates more intelligently, improve review prompting, and centralize release operations through a dashboard-driven workflow. It is stronger than a simple plugin because it includes the operational layer around updates, not just device APIs.
+
+## Core Product Value
+
+- **Speed:** OTA delivery for faster fixes and content changes
+- **Control:** Channels, rollout concepts, rollback support, and update strategy choices
+- **Security:** Signing, checksums, HTTPS posture, and validation tooling
+- **Productivity:** CLI tooling, docs, examples, and dashboard support
+- **Ownership:** Open-source and self-controlled infrastructure options
+
+## Proof Points In Current Repo State
+
+- Native Android and iOS implementations are present
+- CLI package is present
+- Example apps exist under `example-apps/`
+- Website/dashboard project exists under `website/`
+- Security, migration, production-readiness, and API docs are present
+- Current automated package verification passed cleanly on 2026-03-25
+
+## Resume / CV Summary
+
+Built **Native Update**, an open-source Capacitor update platform that unifies OTA delivery, native app updates, in-app reviews, signing and verification, release tooling, example backends, and dashboard-driven update operations for hybrid mobile apps.
+
+## Resume-Ready Achievement Bullets
+
+- Built an open-source Capacitor update platform combining OTA updates, app store update flows, and in-app reviews in one developer-facing package.
+- Implemented cross-platform native support alongside TypeScript APIs, CLI tooling, example backends, and a dashboard-oriented product layer.
+- Added security-focused update delivery features including checksum validation, signature verification, and release workflow tooling.
+- Structured the project around operational update management, not only plugin methods, with docs and examples for real adoption.
+
+## Update History
+
+| Date | Type | Notes |
+| --- | --- | --- |
+| 2026-03-25 | Remediation | Updated verification snapshot to the Yarn-only root package workflow after removing npm and pnpm from the root package path. |
+| 2026-03-24 | Refreshed | Updated metadata, verification snapshot, and repo-state summary to match current package state. |
+| 2026-03-16 | Previous | Prior project profile version. |