HUMANOS FOUNDATION

The Advocacy Kernel for Human Data Sovereignty

Visit the Portal • Read the Manifesto • Join the Revolution

---

"The system only listens when the truth is unignorable. We are building the tools to make your truth undeniable."

🌍 The Mission

The Humanos Foundation is the public advocacy wing of the hOS (Human Operating System) movement. We are a global network of patients, clinicians, and technologists dedicated to dismantling "Assembly-Line Medicine."

This repository powers our digital advocacy platform—an enterprise-grade engine designed to drive waitlist conversions, host our sovereign education library, and organize a worldwide rebellion against institutional data silos.

---

🏗️ Technical Pillars (The Sovereign Stack)

Unlike traditional growth sites, we reject the "surveillance-first" status quo. The foundation platform is architected on three non-negotiable pillars:

Pillar	Philosophy	Implementation
Local-First	Data lives on the device you own, not a server you don't control.	LocalStorage Mock SDK & PWA capabilities.
Zero-Knowledge	We cannot see what we are not meant to see.	Client-side encryption handshakes & private routing.
Radical Transparency	No hidden access. No silent sharing.	Open-source logic and verifiable data ingestion logs.

---

🛠️ Technology & Architecture

This platform provides a visual masterclass in modern, high-performance web aesthetics:

• Logic: React 18 (SPA) optimized for 60fps animations.
• Styling: Tailwind CSS with an custom Glassmorphism Design System.
• Motion: Framer Motion for scroll-synced narratives and biological waveforms.
• Icons: Lucide React for consistent, high-fidelity iconography.
• i18n: Sovereign English/Spanish localization with local-only bundling.

---

🚀 Presentation & Quick Start

1. Prerequisites

• Node.js: v20 or higher
• Git

2. Deployment

git clone https://github.com/RamonRiosJr/humanos.foundation.git
cd humanos.foundation
npm install

3. Launching the "Sovereign Kernel"

To maximize impact during presentations or local advocacy demos, we recommend using the Humanos Operating System Launcher:

Windows (Recommended Experience): Double-click Humanos-Operating-System.bat. This triggers a cinematic terminal boot sequence that initializes the advocacy pipeline, establishes zero-knowledge handshakes, and launches the server.

Cross-Platform:

npm run dev

Access Portal: http://localhost:7200

---

🔒 Security & Selective Privacy

We believe Privacy is a request, but Sovereignty is mathematics.

• Zero Third-Party Trackers: We have purged all unauthorized Google/Meta tracking pixels.
• Privacy Handshake: Optional analytics (PostHog) are loaded dynamically and strictly respect Do-Not-Track headers.
• Sovereign-First forms: Contact and Join data are handled via our internal, privacy-hardened client logic.

For more information, please see our SECURITY.md and Audit Documentation.

---

🤝 The Contributor's Path

We don't just need developers; we need an army.

• Technologists: Help us harden the Zero-Knowledge architecture and optimize the 3D生物 (biological) renders.
• Clinicians: Review our blog content for medical accuracy within the "Root-Cause" framework.
• Patients: Share your history in the Join Funnel to help us map the failures of the status quo.

1. Review the Code of Conduct.
2. Read the Contributor Guidelines.
3. Check the Project Board for active tasks.

---

Built by patients, for patients. Data Sovereignty is a Human Right.

Developed by Ramon Luis Rios Jr @ Coqui Cloud Dev Co.