Welcome to the open data, schemas, and public standards hub of the Dive Kit ecosystem. This repository powers open.divekit.app — the canonical home for all open, machine-readable resources maintained by the Dive Kit project.
lazuli-global/divekit-open-data provides:
- Public Datasets – Canonical, versioned JSON datasets for dive certifications, agencies, cylinders, and dive signals.
- Schemas & Standards – JSON Schema definitions for validating and interoperating with Dive Kit's open data formats.
- Visual Assets – Openly licensed dive signal illustrations (CC BY 4.0), agency logos (third-party trademarks), and Dive Kit branding.
- Documentation – Design guidelines, contributor guidelines, and open-data governance notes.
Our goal is to make diving data accessible, standardized, and developer-friendly, so apps, researchers, and training platforms can all share a common foundation.
divekit-open-data/
├── datasets/
│ ├── certifications.json
│ ├── agencies.json
│ ├── cylinders.json
│ ├── dive-signals.json
│ └── LICENSE.md
│
├── schemas/
│ ├── certifications/
│ │ └── dive-certifications.schema.v1.0.0.json
│ ├── agencies/
│ │ └── agencies.schema.v1.0.0.json
│ ├── cylinders/
│ │ └── cylinders.schema.v1.0.0.json
│ ├── dive-signals/
│ │ └── dive-signals.schema.v1.0.0.json
│ └── LICENSE.md
│
├── assets/
│ ├── dive-signals/ # CC BY 4.0 licensed signal illustrations
│ │ ├── hand/core/
│ │ ├── hand/technical/
│ │ ├── hand/fish-id/
│ │ ├── light/
│ │ ├── buddy-contact/
│ │ └── LICENSE.md
│ ├── agency-logos/ # Third-party trademarks
│ │ └── ...
│ ├── divekit/ # Dive Kit brand assets
│ │ ├── logo.png
│ │ ├── logo-circle-light.png
│ │ ├── logo-circle-dark.png
│ │ └── favicon.png
│
├── docs/
│ ├── DATASETS.md
│ ├── COLORS.md
│ └── LICENSE.md
│
├── scripts/
│ ├── validate.sh
│ └── test-local.sh
│
├── index.html
├── 404.html
├── CONTRIBUTING.md
├── LICENSE.md
└── CNAME (→ open.divekit.app)
| Resource | Description | URL |
|---|---|---|
| Dive Certifications Dataset | Comprehensive global database of scuba certifications and agencies | View JSON → |
| Dive Certifications Schema | JSON Schema for validating certification data | View Schema → |
| Agencies Dataset | List of recognized certifying agencies | View JSON → |
| Agencies Schema | JSON Schema for validating agencies data | View Schema → |
| Cylinder Database | Specifications for common scuba cylinders | View JSON → |
| Cylinder Schema | JSON Schema for validating cylinder data | View Schema → |
| Dive Signals Dataset | Diver communication signals with names, meanings, and artwork | View JSON → |
| Dive Signals Schema | JSON Schema for validating dive signal data | View Schema → |
| Dive Signal Illustrations | CC BY 4.0 vector artwork for every signal in the dataset | View Illustrations → |
| Agency Logos | Collection of scuba diving agency logos | View Logos → |
| Dataset Documentation | Beginner-friendly guide to understanding and contributing | View Guide → |
| Docs | Design guidelines and documentation | View Docs → |
If you're new to working with data or just want to understand what's in these datasets, check out our Dataset Documentation for a beginner-friendly guide.
You can consume the datasets directly from the web:
curl https://open.divekit.app/datasets/certifications.jsonValidate them against the corresponding schema:
npx ajv validate \
-s https://open.divekit.app/schemas/certifications/dive-certifications.schema.v1.0.0.json \
-d https://open.divekit.app/datasets/certifications.jsonUse the dive signal illustrations from assets/dive-signals
in briefing cards, slides, posters, or your own apps. They are licensed CC BY 4.0: free for any use,
including commercial, as long as you credit "Dive signals by Project Dive Kit — https://divekit.app".
Agency logos in assets/agency-logos
are third-party trademarks and should be used for reference purposes only.
Before submitting changes, you can validate the datasets locally:
./scripts/validate.shThis script will:
- ✅ Validate schema files against JSON Schema specifications
- ✅ Validate each JSON dataset file against its referenced schema
- ✅ Check for duplicate IDs within datasets
- ✅ Report detailed errors if validation fails
Requirements:
All pull requests are automatically validated via GitHub Actions.
We welcome contributions of:
- New or corrected certification data
- Updated equivalencies or limits
- Additional recognized agencies
- Translations or metadata
- Documentation improvements
📚 New to contributing? Start with our Dataset Documentation for a step-by-step guide on how to add or update data.
For technical details, see CONTRIBUTING.md for workflow and validation rules.
All JSON datasets must pass schema validation via CI before merging.
Unless otherwise noted:
| Type | License | Notes |
|---|---|---|
| Datasets & Docs | CC BY 4.0 | Free to share/remix with attribution |
| Dive Signal Illustrations | CC BY 4.0 | Credit "Dive signals by Project Dive Kit — https://divekit.app" |
| Schemas & Code | MIT | Free to use in software projects |
| Agency Logos | Third-party trademarks | Owned by respective agencies, reference use only |
| Dive Kit Brand Assets | All rights reserved | Dive Kit trademark, permission required for use |
See LICENSE.md for full details.
Each dataset and schema is versioned semantically (v1.0.0, v1.1.0, …).
Breaking changes will increment the major version.
All changes are tracked via pull requests and validated in CI. Community suggestions are discussed in Discussions.
Dive Kit Open exists to unify how the diving world represents, shares, and understands its data — safely, transparently, and for everyone.
Maintained by: Project Dive Kit Canonical URL: https://open.divekit.app