diff --git a/.gitignore b/.gitignore index 2f2a0ac..4e031a4 100644 --- a/.gitignore +++ b/.gitignore @@ -7,7 +7,5 @@ _site/ .fastembed_cache/ .claude/ -# Internal planning / private material — must NOT land in a public repo -raw-materials.md -ia-education-flagship.md -seo-targets.md +# Internal planning +scratchpad/ diff --git a/src/assets/styles.css b/src/assets/styles.css index f4bb69e..aa2e767 100644 --- a/src/assets/styles.css +++ b/src/assets/styles.css @@ -299,6 +299,19 @@ p { color: var(--seal); } +/* Answer-first paragraph: a direct, extractable answer to the page's primary + query, placed right under the hero. Tuned for SEO/GEO (answer engines read + the top of the page first), so keep it visually quieter than the promise. */ +.hero .direct-answer { + margin-top: 1.25rem; + font-size: 1.02rem; + line-height: 1.6; + color: var(--ink-soft); + max-width: var(--measure); + border-left: 3px solid var(--seal); + padding-left: 1rem; +} + /* ============================ SCENARIO / PULLQUOTE ============================ */ .scenario { margin: 2rem 0; diff --git a/src/verticals/education/index.njk b/src/verticals/education/index.njk index 7eea650..435ab77 100644 --- a/src/verticals/education/index.njk +++ b/src/verticals/education/index.njk @@ -9,12 +9,37 @@ permalink: /education/ --- {# Single-page vertical: SERP magnet, human journey, and technical model on one screen. Answers "would this work for us?" without forcing a click-through. #} +

{{ title }}

Issue diplomas, transcripts, and enrollment proofs that any wallet can hold and any institution can verify — without a central identity provider.

+

+ To issue a digital diploma, a university signs it as a + W3C Verifiable Credential and delivers it to the graduate's + wallet over VCALM (the VC API). Any conformant wallet holds + it; any institution verifies it cryptographically — instantly, across + borders, with no central identity provider. +

@@ -130,10 +155,33 @@ permalink: /education/

-
-

Why VCALM vs. the alternative

-

- You pick a VCALM provider and can swap it. You aren't locked to one wallet - vendor or one stack. See the full comparison. -

-
+
+

Common questions

+
+

How do you issue a digital diploma?

+

+ The university signs the diploma as a W3C Verifiable Credential and + delivers it to the graduate's wallet over VCALM (the VC API). See the + issuer quick start. +

+ +

Can you verify academic credentials online?

+

+ Yes — an admissions office or employer checks the credential's + cryptographic proof and the issuer's identity instantly, with no calls to + the registrar, including across borders. +

+ +

Is there an API to issue student credentials?

+

+ Yes. VCALM (the VC API) is an open W3C HTTP API for issuing, presenting, + and verifying credentials. What is VCALM? +

+ +

Why VCALM vs. OID4?

+

+ You pick a VCALM provider and can swap it. You aren't locked to one wallet + vendor or one stack. See the full comparison. +

+
+
diff --git a/src/verticals/government/index.njk b/src/verticals/government/index.njk index 1d3df84..8276681 100644 --- a/src/verticals/government/index.njk +++ b/src/verticals/government/index.njk @@ -9,6 +9,24 @@ permalink: /government/ --- {# Single-page government/DMV vertical. Anchor: mobile driver's license (mDL). Lean on wallet-choice / no-allow-list / privacy — the user-liberty angle. #} +

{{ title }}

@@ -16,6 +34,14 @@ permalink: /government/ verifiable in person or online, with the wallet of their choice, and without locking citizens to a government-approved app.

+

+ To issue a mobile driver's license, a DMV signs it as a + W3C Verifiable Credential and delivers it to the resident's + wallet of choice over VCALM (the VC API). A relying party + verifies it cryptographically — in person or online — and with selective + disclosure the resident can prove one fact, like "over 21," without + revealing name, address, or birthdate. +

@@ -130,12 +156,36 @@ permalink: /government/

-
-

Why VCALM vs. the alternative

-

- The OpenID-based, mdoc-centric approach often pairs with wallet "attestation" - and allow-lists — the state, in effect, picks which apps citizens may use. - VCALM keeps wallet choice with the resident and works natively with W3C - Verifiable Credentials. See the full comparison. -

-
+
+

Common questions

+
+

Can a digital ID prove age without revealing a birthdate?

+

+ Yes. With selective disclosure, a resident proves a single fact — "over + 21," "license valid" — without revealing name, address, or birthdate. +

+ +

Does a mobile driver's license lock residents to a government app?

+

+ Not with VCALM — the license works with any conformant wallet. The + OpenID/mdoc approach often pairs with attestation and allow-lists that let + the state decide which apps are accepted. +

+ +

Is a VCALM mobile driver's license private?

+

+ Yes. Data minimization is built into every request, nothing is shared + without one-tap consent, and the state can't see where it's used. +

+ +

Why VCALM vs. OID4?

+

+ The OID4VCI / OID4VP, mdoc-centric approach often pairs with wallet + "attestation" and allow-lists — which means the DMV has to certify, and + build and maintain an integration for, every wallet it wants to support. + With VCALM, you issue once to an open standard and any conformant wallet + works, so there's no per-wallet integration to own. See + the full comparison. +

+
+
diff --git a/src/verticals/supply-chain/index.njk b/src/verticals/supply-chain/index.njk index a9370e6..4c3d8ca 100644 --- a/src/verticals/supply-chain/index.njk +++ b/src/verticals/supply-chain/index.njk @@ -10,6 +10,24 @@ permalink: /supply-chain/ {# Single-page supply-chain vertical. US-first: lead with "supply chain traceability / provenance" (US vocabulary; DSCSA/FSMA/UFLPA drivers). "Digital product passport" / DPP is the secondary EU framing. #} +

{{ title }}

@@ -17,6 +35,14 @@ permalink: /supply-chain/ so buyers, retailers, auditors, and customs can verify origin instantly, and counterfeits have nowhere to hide.

+

+ To build a digital product passport, a manufacturer signs a provenance + credential as a W3C Verifiable Credential over + VCALM (the VC API) and links it to the item. The credential + travels with the product; any buyer, retailer, or auditor verifies origin + cryptographically — no central database. The same record is called a + Digital Product Passport (DPP) in the EU. +

@@ -147,11 +173,37 @@ permalink: /supply-chain/

-
-

Why VCALM vs. the alternative

-

- You pick a VCALM provider and can swap it. The credential works with any - conformant wallet or scanner — you aren't locked to one vendor's app across - your whole supply chain. -

-
+
+

Common questions

+
+

What is a digital product passport (DPP)?

+

+ A tamper-evident, portable record of a product's origin, materials, and + conformity — mandated in the EU by the ESPR, and issued as a W3C + Verifiable Credential. It's the same capability the US calls supply chain + traceability and provenance. +

+ +

How do verifiable credentials prevent counterfeiting?

+

+ A genuine product carries a signed authenticity credential a counterfeiter + can't forge. Anyone can verify it without contacting the brand, so fakes + can't produce a valid credential. +

+ +

Does this meet DSCSA, FSMA, or UFLPA requirements?

+

+ Verifiable Credentials over VCALM provide the tamper-evident, portable + provenance these rules require — proof that travels with the product, with + no central database to breach. +

+ +

Why VCALM vs. OID4?

+

+ You pick a VCALM provider and can swap it. The credential works with any + conformant wallet or scanner — you aren't locked to one vendor's app + across your whole supply chain. See the full + comparison. +

+
+
diff --git a/src/why-vcalm.njk b/src/why-vcalm.njk index ee1e32d..626b783 100644 --- a/src/why-vcalm.njk +++ b/src/why-vcalm.njk @@ -3,14 +3,41 @@ layout: layouts/base.njk title: "VCALM vs OID4VCI / OID4VP — Why VCALM" description: "VCALM vs OID4VP and OID4VCI: a clear comparison for issuing and verifying Verifiable Credentials. Wallet choice, no vendor lock-in, one simple flow, native W3C VC support." permalink: /why-vcalm/ +structuredData: + "@context": "https://schema.org" + "@type": "TechArticle" + headline: "VCALM vs OID4VCI / OID4VP" + about: "Comparison of VCALM (the VC API) with the OpenID4VC protocols" + description: "How VCALM compares to OID4VCI and OID4VP for issuing and verifying Verifiable Credentials: wallet choice, vendor lock-in, flow, and W3C VC support." + author: + "@type": "Organization" + name: "Digital Bazaar, Inc." --- +

Why VCALM

- Both VCALM and the OpenID-based specs (OID4VCI and OID4VP) move credentials - between issuers, wallets, and verifiers. The difference is who stays in - control — the user, or the vendor. Here's what you get with VCALM, and where - the OpenID approach differs. + VCALM is an alternative to OID4VCI and OID4VP. All three + move credentials between issuers, wallets, and verifiers, but VCALM does it + in one exchange loop, keeps the user's choice of wallet, and carries W3C + Verifiable Credentials natively — where the OpenID specs split issuance and + presentation across two protocols and can restrict which wallets are + accepted. The difference is who stays in control: the user, or the vendor.

@@ -103,6 +130,34 @@ permalink: /why-vcalm/
+
+

Common questions

+
+

Is VCALM an alternative to OpenID4VP?

+

+ Yes. VCALM covers the same ground as OID4VCI and OID4VP — moving + credentials between issuers, wallets, and verifiers — while keeping + wallet choice with the user and avoiding vendor lock-in across the + lifecycle. +

+ +

Does OID4VCI support W3C Verifiable Credentials?

+

+ The OpenID4VC high-assurance profile (HAIP) is scoped to SD-JWT and ISO + mdoc formats and does not include W3C Verifiable Credentials. VCALM + carries standards-compliant W3C Verifiable Credentials natively. +

+ +

When should I choose VCALM?

+

+ When you want users to keep their choice of wallet, want to swap + providers without re-integrating across the stack, want issuance and + presentation in one flow, and have standardized on W3C Verifiable + Credentials. +

+
+
+

The simplest way to judge for yourself: look at what a developer actually implements.