diff --git a/assets/bootstrap.js b/assets/bootstrap.js new file mode 100644 index 0000000..2ea01c0 --- /dev/null +++ b/assets/bootstrap.js @@ -0,0 +1,4 @@ +import Collapse from './vendor/bootstrap/js/src/collapse.js' + +window.bootstrap = window.bootstrap || {} +window.bootstrap.Collapse = Collapse diff --git a/assets/main.scss b/assets/main.scss index 9b1eed4..d4dde7d 100644 --- a/assets/main.scss +++ b/assets/main.scss @@ -32,7 +32,7 @@ $primary: #000; // @import "../vendor/bootstrap/scss/breadcrumb"; // @import "../vendor/bootstrap/scss/pagination"; @import "../vendor/bootstrap/scss/badge"; -// @import "../vendor/bootstrap/scss/alert"; +@import "../vendor/bootstrap/scss/alert"; // @import "../vendor/bootstrap/scss/progress"; // @import "../vendor/bootstrap/scss/list-group"; // @import "../vendor/bootstrap/scss/close"; @@ -85,3 +85,9 @@ $bootstrap-icons-font-dir: "./"; box-shadow: 0 12px 24px rgba(0, 0, 0, 0.15) !important; } } + +.highlight pre { + background: transparent !important; + @extend .mb-0; + @extend .p-4; +} diff --git a/config/_default/config.toml b/config/_default/config.toml index 242dd1d..84d5836 100644 --- a/config/_default/config.toml +++ b/config/_default/config.toml @@ -6,3 +6,15 @@ staticDir = [ './vendor/bootstrap-icons/font/fonts', './static' ] description = 'The JSON Schema Registry. Enterprise-grade, high-performance, and self-hosted' github = 'https://github.com/sourcemeta' email = 'hello@sourcemeta.com' + +[markup] + [markup.highlight] + style = 'swapoff' + +[[module.mounts]] +source = "assets" +target = "assets" + +[[module.mounts]] +source = "vendor/bootstrap/js" +target = "assets/vendor/bootstrap/js" diff --git a/content/_index.html b/content/_index.html index f4e8d54..f17db7c 100644 --- a/content/_index.html +++ b/content/_index.html @@ -1,5 +1,26 @@ +++ title = "Home" +github = "sourcemeta/registry" + +[[navigation]] +title = "Docs" +link = "https://registry.sourcemeta.com" + +[[navigation]] +title = "Features" +link = "#features" + +[[navigation]] +title = "Pricing" +link = "#pricing" + +[[navigation]] +title = "Open Source" +link = "#opensource" + +[[navigation]] +title = "Support" +link = "https://github.com/sourcemeta/registry/discussions" +++ {{< blueprint color="white" class="border-top pt-4 pt-md-5 pb-3" >}} @@ -80,31 +101,7 @@

{{< /components/ribbon >}} -
-
-
-
- - JSON Schema for OpenAPI course -
-
- -
-
- -
-
-
-
-

Master JSON Schema for OpenAPI

-

Learn advanced patterns, schema-first design, and production-grade techniques from a member of the JSON Schema Technical Steering Committee. 14 modules and over 9 hours of content covering the entirety of JSON Schema 2020-12, from basics all the way to dynamic references.

- Take the Video Course -
-
-
-
-
-
+{{< promotion >}}
@@ -183,25 +180,7 @@

Designed to solve schema management at scale<

- {{< callout >}} -
- - Juan Cruz Viotti - -
- -
-
Do you have any questions?
-

I'm Juan Cruz Viotti, founder of Sourcemeta, member of the JSON Schema Technical Steering Committee, O'Reilly author, and award-winning University of Oxford alumnus.

-

I'd love to discuss how JSON Schema, OpenAPI, and Sourcemeta tooling can help you build world class APIs.

- - -
- {{< /callout >}} + {{< talk-to-us >}}
diff --git a/content/products/_index.html b/content/products/_index.html new file mode 100644 index 0000000..4e0ce95 --- /dev/null +++ b/content/products/_index.html @@ -0,0 +1,3 @@ ++++ +title = "Products" ++++ diff --git a/content/products/std/_index.html b/content/products/std/_index.html new file mode 100644 index 0000000..47428d5 --- /dev/null +++ b/content/products/std/_index.html @@ -0,0 +1,547 @@ ++++ +title = "JSON Schema Standard Library" +description = "A standard library of all the foundational schemas you'll ever need so you never have to bother with JSON Schema again" +github = "sourcemeta/std" + +[[navigation]] +title = "Browse Schemas" +link = "https://schemas.sourcemeta.com/sourcemeta/std" + +[[navigation]] +title = "Pricing" +link = "#pricing" + +[[navigation]] +title = "FAQ" +link = "#faq" + +[[navigation]] +title = "Open Source" +link = "#opensource" ++++ + +{{< blueprint color="white" class="border-top pt-4 pt-md-5 pb-5" >}} +
+

+ World-class OpenAPI specs without the schema grind +

+

+ World-class OpenAPI specs without the schema grind +

+ +

A standard library of all the foundational schemas you'll ever need—from email addresses to currency codes—so you never have to bother with JSON Schema again

+ +
+ + Get Lifetime Access + + + + Browse Schemas + +
+ + +
+

+ Commercial library with perpetual pricing. Pay once, own forever +

+
+ + +
+ Maintained by a member of the JSON Schema Technical Steering Committee +
+
+ +
+
+
+
+
+ +
+

Before

+
+ {{< editor filename="openapi.yaml" type="fail" language="yaml" details="100+ lines of repetitive validation code|Broken regex patterns copied from ChatGPT|Incomplete or incorrect enumerations|No standards compliance guarantees" >}}openapi: 3.1.0 +paths: + /users: + post: + requestBody: + content: + application/json: + schema: + type: object + properties: + email: + type: string + pattern: '^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$' + description: Email address + country: + type: string + pattern: '^[A-Z]{2}$' + description: ISO 3166-1 alpha-2 country code + currency: + type: string + enum: [ AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, FOK, GBP, GEL, GGP, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, IMP, INR, IQD, IRR, ISK, JEP, JMD, JOD, JPY, KES, KGS, KHR, KID, KMF, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL ] + description: ISO 4217 currency code + website: + type: string + pattern: '^https?:\/\/(www\.)?[-a-zA-Z0-9@:%._\+~#=]{1,256}\.[a-zA-Z0-9()]{1,6}\b([-a-zA-Z0-9()@:%_\+.~#?&//=]*)$' + description: Website URL + created_at: + type: string + pattern: '^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{3})?Z?$' + description: ISO 8601 datetime + language: + type: string + pattern: '^[a-z]{2}(-[A-Z]{2})?$' + description: Language code{{< /editor >}} +
+
+ +
+
+
+
+ +
+

After

+
+ {{< editor filename="openapi.yaml" type="success" language="yaml" details="Clean and readable OpenAPI definitions|Standards-backed validation (IETF RFC's, ISO, etc)|Guaranteed schema correctness|Took 5 minutes to write" >}}openapi: 3.1.0 +paths: + /users: + post: + requestBody: + content: + application/json: + schema: + type: object + properties: + email: + $ref: './std/ietf/email/address.json' + country: + $ref: './std/iso/country/2020/alpha-2.json' + currency: + $ref: './std/iso/currency/2015/alpha-code.json' + website: + $ref: './std/ietf/uri/url.json' + created_at: + $ref: './std/iso/datetime/2019/datetime/calendar-extended.json' + language: + $ref: './std/ietf/language/tag.json'{{< /editor >}} +
+
+
+{{< /blueprint >}} + +
+
+
+
+

Built on the foundations of our digital world

+

Every schema in this library represents careful implementation of the standards that power the modern internet (many behind expensive paywalls), ensuring your APIs are built on proven, battle-tested, and compliant foundations.

+
+
+
+
+ + IETF + + + ISO + + + IEEE + +
+
+ + IEC + + + W3C + +
+
+
+
+
+
+ +
+
+
+

Most API companies waste months reinventing the wheel, and still doing it wrong

+

Your company is smarter than that

+
+ +
+
+ {{< box header="Correctness" icon="bi-arrow-repeat" title="You are writing schemas that are likely broken" >}} + Thousands of developers waste time reinventing the same complex foundational schemas, each with their own bugs and edge cases. +
+

And you are probably not even unit testing your schemas for correctness

+ {{< /box >}} +
+
+ {{< box header="Strictness" icon="bi-toggles" title="Your schemas are either too complex or uselessly loose" >}} + Designing robust and correct schemas takes a ton of time, deep expertise, and access to standards. But you need to ship your APIs yesterday. +
+

And you might even be introducing security vulnerabilities with overly loose schemas

+ {{< /box >}} +
+
+ {{< box header="Productivity" icon="bi-hourglass-split" title="Writing schemas from scratch takes 100x longer" >}} + Designing schemas is time consuming. Snap in battle-tested schemas like building blocks and ship your OpenAPI specs in hours, not weeks. +
+

Why waste your time designing complex schemas that have already been designed?

+ {{< /box >}} +
+
+
+
+ +
+
+
+

Use the schemas your way

+

We don't lock you in. Choose the method that works best for your workflow

+
+ +
+
+
+
+ HTTPS URLs +
+

HTTPS URLs

+

Directly reference schemas from schemas.sourcemeta.com using the $ref JSON Schema keyword and de-reference them with well known OpenAPI tools like redocly bundle

+
+
+
+
+
+ OpenAPI Editors +
+

OpenAPI Editors

+

Most popular OpenAPI editors, such as Scalar, can de-reference external HTTPS requests to schemas hosted in public schema registries like schemas.sourcemeta.com

+
+
+
+
+
+ Git Submodule +
+

Git Submodule

+

Our schemas are publicly available on GitHub. Pull them as a submodule like any other dependency and reference them from your OpenAPI specs using relative file paths

+
+
+
+
+
+ Schema Registries +
+

Schema Registries

+

For extra power and organisation-wide API Governance programs, ingest the schemas in JSON Schema 2020-12 compatible registries like the Sourcemeta Registry

+
+
+
+
+
+ Download Archive +
+

Download Archive

+

Often useful in scripting environments. Fetch the latest ZIP or tarball from GitHub Releases and use the JSON files that come with it as you wish

+
+
+
+
+
+ Copy & Paste +
+

Copy & Paste

+

Sometimes you don't need to get fancy. You can always browse the schemas in schemas.sourcemeta.com and just copy-paste the ones you need

+
+
+
+
+
+ +
+
+

Pricing

+ +

All schemas are publicly available on GitHub for evaluation, auditing, and contributions. However, any use of these schemas related to a for-profit product or service requires a commercial license. Read the license document for more details.

+ +

Do you have questions regarding the license? Don't hesitate to reach out!

+ +
+
+
+
+
+

Community

+

€0

+

Free forever for non-commercial projects such as personal projects, open specifications, research, and open-source organisations.

+

Note: Requires attribution

+ View on GitHub +
+
+
+
+

OEM

+

Custom

+

Offer our schemas to your end users as part of your own product (i.e. OpenAPI editors and API management platforms) in a white-labelling manner and without attribution

+ Let's Talk! +
+
+
+
+
+
+
+ Most Popular +
+
+
+

Commercial

+
+
+

€2,110

+

One-time payment

+ +
    +
  • Commercial use (for a single company)
    • +
  • Lifetime access
    • +
  • Free updates forever
    • +
  • All future schemas included
    • +
  • Premium support (Slack Connect or Discord)
    • +
  • Publish public OpenAPI specs that use our schemas
    • +
  • Request any new schemas you need
    • +
+ +
+ Purchase License +

Contact us for a full refund within 30-days of purchase. No questions asked

+
+
+
+
+
+
+ +
+

This library is maintained by a member of the JSON Schema Technical Steering Committee. Your purchase directly supports our open-source contributions and continuous involvement in the JSON Schema ecosystem. Thanks for your help making the JSON Schema standard thrive!

+
+
+
+ +
+
+
+

An investment that quickly pays for itself

+

Solve the OpenAPI authoring problem for your company forever

+
+ +
+
+
+
+

A week of developer salary

+

A fraction of the time and cost to produce these schemas yourself

+
+
+
+
+
+

Perpetual ownership

+

Every project, every team, forever. Including all new schemas

+
+
+
+
+
+

World-class support included

+

Have an API and JSON Schema expert on your speed dial for help

+
+
+
+
+
6+
+

Months of work saved per API

+

Avoid a whole class of input/output correctness and security bugs

+
+
+
+ + {{< talk-to-us >}} +
+
+ +
+
+
+

Trusted by elite API architects

+

See what the world's leading specification experts are saying

+
+ +
+
+ {{< testimonial github="ronitelman" name="Ron Itelman" role="Founder, TrustLoop" >}}This is definitely going to become an incredibly important reference library for defining concepts using best in class standards{{< /testimonial >}} +
+ +
+ {{< testimonial github="mwadams" name="Matthew Adams" role="Founder, Endjin" >}}This is a terrific project and should be a standard subscription for any enterprise working with JSON Schema{{< /testimonial >}} +
+
+
+
+ +
+
+

Frequently Asked Questions

+ +

Do you have any other questions regarding the schemas? Don't hesitate to reach out!

+ +
+
+

+ +

+
+
+

Yes. However, if your API is for-profit, you'll need a commercial license. Your end users can freely consume your published OpenAPI specification without needing their own license, as they're using your specification rather than directly consuming our schemas.

+
+
+
+ +
+

+ +

+
+
+

Absolutely. These schemas are designed as composable building blocks. Reference them, extend them, or add additional constraints as you wish.

+
+
+
+ +
+

+ +

+
+
+

All schemas target JSON Schema 2020-12, which is the dialect used by OpenAPI v3.1 and later. Support for earlier JSON Schema dialects will be added in future releases.

+
+
+
+ +
+

+ +

+
+
+

We regularly update schemas to reflect new standards, fix bugs, and expand coverage for additional specifications. We follow semantic versioning, so you can upgrade at your own pace without breaking existing specifications.

+
+
+
+ +
+

+ +

+
+
+

Yes. We welcome contributions via pull requests on GitHub.

+
+
+
+ +
+

+ +

+
+
+

Yes, as long as you preserve the license-related metadata keywords that identify the schema origin and licensing terms for downstream consumers.

+
+
+
+ +
+

+ +

+
+
+

Yes. This qualifies under the Community license. Users of your specification can freely use the schemas as they are consuming your specification rather than our schemas directly.

+
+
+
+ +
+

+ +

+
+
+

Yes. A commercial license is required for any for-profit venture, regardless of whether your code is open-source.

+
+
+
+ +
+

+ +

+
+
+

If you use the schemas unmodified, the embedded metadata provides automatic attribution. No additional action is required.

+
+
+
+
+
+
+ +{{< blueprint color="dark" class="border-top py-5" >}} +
+

Ready to solve OpenAPI design
at your company forever?

+

One payment. Perpetual access. Never write schemas from scratch again.

+ +
+ + Get Lifetime Access + + + Browse Schemas First + +
+ + + + 30-day money-back guarantee • Maintained by a JSON Schema TSC member + +
+{{< /blueprint >}} diff --git a/content/products/std/from-copypaste.png b/content/products/std/from-copypaste.png new file mode 100644 index 0000000..85c5d46 Binary files /dev/null and b/content/products/std/from-copypaste.png differ diff --git a/content/products/std/from-editors.png b/content/products/std/from-editors.png new file mode 100644 index 0000000..679a2e1 Binary files /dev/null and b/content/products/std/from-editors.png differ diff --git a/content/products/std/from-https.png b/content/products/std/from-https.png new file mode 100644 index 0000000..3193f34 Binary files /dev/null and b/content/products/std/from-https.png differ diff --git a/content/products/std/from-registry.png b/content/products/std/from-registry.png new file mode 100644 index 0000000..f092a30 Binary files /dev/null and b/content/products/std/from-registry.png differ diff --git a/content/products/std/from-submodule.png b/content/products/std/from-submodule.png new file mode 100644 index 0000000..fa744b1 Binary files /dev/null and b/content/products/std/from-submodule.png differ diff --git a/content/products/std/from-zip.png b/content/products/std/from-zip.png new file mode 100644 index 0000000..09529e5 Binary files /dev/null and b/content/products/std/from-zip.png differ diff --git a/content/products/std/iec.svg b/content/products/std/iec.svg new file mode 100644 index 0000000..2b01f1a --- /dev/null +++ b/content/products/std/iec.svg @@ -0,0 +1,11 @@ + + + + + + + + + + + diff --git a/content/products/std/ieee.svg b/content/products/std/ieee.svg new file mode 100644 index 0000000..46a68e3 --- /dev/null +++ b/content/products/std/ieee.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/content/products/std/ietf.svg b/content/products/std/ietf.svg new file mode 100644 index 0000000..1d0faac --- /dev/null +++ b/content/products/std/ietf.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/content/products/std/iso.svg b/content/products/std/iso.svg new file mode 100644 index 0000000..54ed3b1 --- /dev/null +++ b/content/products/std/iso.svg @@ -0,0 +1,15 @@ + + + + + + + + + + + + + + + diff --git a/content/products/std/w3c.svg b/content/products/std/w3c.svg new file mode 100644 index 0000000..25161a5 --- /dev/null +++ b/content/products/std/w3c.svg @@ -0,0 +1,6 @@ + + + + + + diff --git a/layouts/_default/baseof.html b/layouts/_default/baseof.html index 914666a..12bfc99 100644 --- a/layouts/_default/baseof.html +++ b/layouts/_default/baseof.html @@ -33,5 +33,7 @@ {{ end }} {{ partial "footer.html" . }} + {{ $js := resources.Get "bootstrap.js" | js.Build (dict "minify" true) }} + diff --git a/layouts/courses/list.html b/layouts/courses/list.html index dc58e58..a4fdc12 100644 --- a/layouts/courses/list.html +++ b/layouts/courses/list.html @@ -36,5 +36,7 @@ {{ partial "opensource.html" . }} {{ partial "footer.html" . }} + {{ $js := resources.Get "bootstrap.js" | js.Build (dict "minify" true) }} + diff --git a/layouts/partials/navigation.html b/layouts/partials/navigation.html index 8f8cf3e..b98ae06 100644 --- a/layouts/partials/navigation.html +++ b/layouts/partials/navigation.html @@ -7,28 +7,14 @@