🌐 Benefit Plan Standard — Documentation

The official documentation site for the open, vendor-neutral data standard for representing U.S. health insurance benefit plans.

---

📘 About the Standard

The Benefit Plan Standard (BPS) defines a unified, machine-readable schema for representing health insurance benefit plans across U.S. carriers.
It provides:

• Canonical field definitions
• Standardized terminology
• Cross-carrier vocabulary mapping
• Schema-level validation rules
• Extensible modules (pharmacy, behavioral health, dental/vision, supplemental benefits)
• A normalized data model for analytics, automation, and interoperability

Supported plan types include SBCs, EOCs, ACA plans, employer group plans, Medicare Advantage, and more.

All official documentation is published at:

👉 https://benefitplanstandard.org

---

📁 Repository Purpose

This repository contains the complete Docusaurus-based documentation website for the Benefit Plan Standard.

It includes:

• docs/ — Specification, governance, compliance, examples
• scripts/ — Automation scripts (Google Sheets → HTML crosswalk)
• static/ — images, assets, CNAME
• sidebars.js - Sidebar navigation configuration
• docusaurus.config.js — Global site configuration

The JSON Schema itself is maintained in a separate repository:

👉 https://github.com/Benefit-Plan-Standard/benefit-plan-schema

---

🔄 Automated Crosswalk Pipeline

This documentation includes a GitHub Actions workflow that automatically updates the Carrier Crosswalk section of the site.

The pipeline performs

• Fetching the published Google Sheets crosswalk source
• Converting each tab into HTML tables
• Injecting the tables directly into /docs/specification/crosswalk.md
• Running validation to ensure clean formatting
• Deploying the updated site on every push

Key files

• scripts/generateCrosswalk.js
• scripts/utils.js
• .github/workflows/deploy.yml

This ensures the crosswalk tables remain accurate and always in sync with the working standard.

---

🏗 Development Workflow

Install dependencies

npm install

Run the documentation site locally

npm start

Build for production

npm run build

Regenerate the crosswalk tables from Google Sheets

npm run generate:crosswalk

🤝 Contributing

Contributions are welcome from carriers, brokers, TPAs, health-tech developers, researchers, and standards organizations.

Please review:

• CONTRIBUTING.md
• CODE_OF_CONDUCT.md

We encourage community discussions, issue reports, and pull requests that help improve the clarity, accuracy, and usability of the standard.

📬 Contact

📧 contact@benefitplanstandard.org

🌐 https://benefitplanstandard.org