diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
index 3c8063b..f104176 100644
--- a/.github/workflows/deploy.yml
+++ b/.github/workflows/deploy.yml
@@ -1,19 +1,37 @@
-name: Build and Deploy
+name: Deploy to GitHub Pages
+
 on:
   push:
-    branches:
-      - main
+    branches: [ main ]
+  workflow_dispatch:
+
 permissions:
-  contents: write
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
 jobs:
-  build-and-deploy:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
     runs-on: ubuntu-latest
     steps:
-      - name: Checkout 🛎️
+      - name: Checkout
         uses: actions/checkout@v4
-
-      - name: Deploy 🚀
-        uses: JamesIves/github-pages-deploy-action@v4.7.2
+      
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+      
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
         with:
-          branch: gh-pages # The branch the action should deploy to.
-          folder: static
\ No newline at end of file
+          path: './docs'
+      
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
\ No newline at end of file
diff --git a/docs/2021-10-12_Update-vLEI-IIW_v1.1_final.pdf b/docs/2021-10-12_Update-vLEI-IIW_v1.1_final.pdf
deleted file mode 100644
index e176ca4..0000000
Binary files a/docs/2021-10-12_Update-vLEI-IIW_v1.1_final.pdf and /dev/null differ
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 0000000..1d0da0e
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,38 @@
+# vLEI Credential Documentaion
+
+## Quick Start
+
+1. **Local Development:**
+
+From `./docs`
+
+   ```bash
+   python3 -m http.server 8000
+   ```
+
+Visit: <http://localhost:8000>
+
+2. **Content Changes:**
+   - Edit `.md` files in the `content/` directory
+   - Refresh browser to see changes
+
+## Content Management
+
+### Adding New Pages
+
+1. **Create content file:** Add `new-page.md` to `content/` directory
+2. **Register file:** Add `'new-page'` to the `knownFiles` array in `app.js`
+3. **Add navigation:** Update navbar in `index.html` if needed
+
+### Internal Links
+
+- **Page:** `[New Page](new-page)`
+
+### Mermaid Diagrams
+
+```content
+\`\`\`mermaid
+graph TD
+    A[Start] --> B[End]
+\`\`\`
+```
diff --git a/docs/Schema_Registry.md b/docs/Schema_Registry.md
deleted file mode 100644
index bd6540a..0000000
--- a/docs/Schema_Registry.md
+++ /dev/null
@@ -1,56 +0,0 @@
-# verifiable LEI (vLEI) Ecosystem Governance Framework vLEI Credential Schema Registry
-This Controlled Document will cover all policies regarding the publication of the official JSON Schema for the vLEI credentials.
-
-##	Related Specifications
-####	JSON Schema
-JSON Schema 2020-12
-https://json-schema.org/draft/2020-12/release-notes.html
-
-####	ACDC
-IETF ACDC (Authentic Chained Data Containers) Internet Draft
-https://github.com/trustoverip/tswg-acdc-specification
-
-####	SAID
-IETF SAID (Self-Addressing IDentifier) Internet Draft
-https://github.com/WebOfTrust/ietf-said
-
-####	CESR
-IETF CESR (Composable Event Streaming Representation) Internet Draft
-https://github.com/WebOfTrust/ietf-cesr
-
-#### Semantic Versioning
-Semantic Versioning Specification 2.0
-https://semver.org
-
-##	Official vLEI Credential Schema
-
-
-### Requirements
-
-A SAID is an encoded agile cryptographic digest of the contents of the schema. Any change to the schema results in a new SAID. Therefore each and every version of any schema has a universally unique SAID across all schema and all versions of all schema. Any copy of a schema that verifies against the SAID published in the following table can be assumed to be identical to any other copy that verifies to the same SAID by virtue of the strong collision resistance of the digest employed. The digest algorithm employed for generating schema SAIDS MUST have an approximate cryptographic strength of 128 bits. The SAID MUST be generated in compliance with the IETF-SAID internet draft specification and MUST be encoded using CESR. The CESR encoding indicates the type of cryptographic digest used to generate the SAID. The schema MUST be JSON-Schema 2020-12 compliant. The table below provides the normative SAIDs (Self-Addressing-IDentifiers) for each of the official schemas.
-
-### Versioning
-
-As ACDCs, the vLEI schema uses composition operators from JSON Schema. This allows extensibility in schema such that in many cases, newer schema versions may be backward compatible with older schema versions. A new schema version is considered backward incompatible with respect to a previous version of a schema when any instance of a vLEI credential that validates against the previous version of the schema may not be guaranteed to validate against the new version. As per the semantic versioning rules, a backward incompatible schema MUST have a higher MAJOR version number than any backward incompatible version.
-
-### Schema Table
-
-The following table provides, in descending order, row-by-row, the latest version, the SAID, and the type of each official schema, along with a URL. The URL is a network location where a copy of the schema may be obtained. Updated versions will be added to the top of the table upon designation by GLEIF as official. The version number for each schema follows the Semantic Versioning 2.0.0 specification.
-
-
-| Version | SAID | Type | URL | 
-|-:|:-|:-|:-|
-| `1.0.0` | `ELqriXX1-lbV9zgXP4BXxqJlpZTgFchll3cyjaCyVKiz` | QualifiedvLEIIssuervLEICredential | https://github.com/WebOfTrust/vLEI/blob/dev/schema/acdc/qualified-vLEI-issuer-vLEI-credential.json |
-| `1.0.0` | `EK0jwjJbtYLIynGtmXXLO5MGJ7BDuX2vr2_MhM9QjAxZ` | LegalEntityvLEICredential | https://github.com/WebOfTrust/vLEI/blob/dev/schema/acdc/legal-entity-vLEI-credential.json |
-| `1.0.0` | `EDqjl80uP0r_SNSp-yImpLGglTEbOwgO77wsOPjyRVKy` | OORAuthorizationvLEICredential | https://github.com/WebOfTrust/vLEI/blob/dev/schema/acdc/oor-authorization-vlei-credential.json |
-| `1.0.0` | `EIL-RWno8cEnkGTi9cr7-PFg_IXTPx9fZ0r9snFFZ0nm` | LegalEntityOfficialOrganizationalRolevLEICredential | https://github.com/WebOfTrust/vLEI/blob/dev/schema/acdc/legal-entity-official-organizational-role-vLEI-credential.json |
-| `1.0.0` | `ED_PcIn1wFDe0GB0W7Bk9I4Q_c9bQJZCM2w7Ex9Plsta` | ECRAuthorizationvLEICredential | https://github.com/WebOfTrust/vLEI/blob/dev/schema/acdc/ecr-authorization-vlei-credential.json |
-| `1.0.0` | `EOhcE9MV90LRygJuYN1N0c5XXNFkzwFxUBfQ24v7qeEY` | LegalEntityEngagementContextRolevLEICredential | https://github.com/WebOfTrust/vLEI/blob/dev/schema/acdc/legal-entity-engagement-context-role-vLEI-credential.json |
-| `1.0.0` | `EJEMDhCDi8gLqtaXrb36DRLHMfC1c08PqirQvdPPSG5u` | iXBRLDataAttestation | https://github.com/WebOfTrust/vLEI/blob/dev/schema/acdc/verifiable-ixbrl-report-attestation.json |
-
-
-
-## Informative Notes
-At some time in the future, this registry document may be augmented with a live registry that follows the future ToIP Trust Registry Protocol specification. The current incomplete draft may be found here:
-https://docs.google.com/document/d/1ZGXUB0oODHO66PQkO66-fbAu6f7sVVToOz3Q8RNG0fs/edit
-
diff --git a/docs/app.js b/docs/app.js
new file mode 100644
index 0000000..bd5569f
--- /dev/null
+++ b/docs/app.js
@@ -0,0 +1,168 @@
+mermaid.initialize({
+  startOnLoad: true,
+  theme: 'default',
+  flowchart: {
+    useMaxWidth: true,
+    htmlLabels: true,
+    curve: 'linear'
+  },
+  elk: {
+    'elk.algorithm': 'layered',
+    'elk.direction': 'DOWN',
+    'elk.layered.spacing.nodeNodeBetweenLayers': 50,
+    'elk.layered.spacing.edgeNodeBetweenLayers': 20,
+    'elk.edge.routing': 'ORTHOGONAL', 
+    'elk.layered.edgeRouting.selfLoopDistribution': 'EQUALLY',
+    'elk.layered.nodePlacement.strategy': 'BRANDES_KOEPF',
+    'elk.layered.crossingMinimization.strategy': 'LAYER_SWEEP'
+  }
+});
+
+const contentFiles = {};
+
+const knownFiles = [
+  'index', 'credentials', 'vlei-credential-ecosystem', 'vlei-dependency-graph',
+  'qvi-credential-schema', 'legal-entity-credential-schema', 'ecr-credential-schema',
+  'oor-credential-schema', 'ecr-auth-credential-schema', 'oor-auth-credential-schema'
+];
+
+async function loadcontentFiles() {
+  console.log('Loading content files...');
+  let loadedCount = 0;
+  
+  for (const file of knownFiles) {
+    try {
+      const response = await fetch(`content/${file}.md`);
+      if (response.ok) {
+        contentFiles[file] = await response.text();
+        loadedCount++;
+        console.log(`✓ Loaded ${file}.md`);
+      } else {
+        console.log(`✗ Failed to load ${file}.md (${response.status})`);
+      }
+    } catch (error) {
+      console.log(`✗ Error loading ${file}.md:`, error);
+    }
+  }
+  
+  console.log(`Loaded ${loadedCount} of ${knownFiles.length} content files`);
+}
+
+async function loadPage(pageName) {
+  const content = document.getElementById('content-content');
+  
+  if (!contentFiles[pageName]) {
+    content.innerHTML = `
+      <div class="loading">
+        <h2>Page Not Found</h2>
+        <p>The requested page "${pageName}" could not be loaded.</p>
+      </div>
+    `;
+    return;
+  }
+
+  content.innerHTML = '<div class="loading">Loading...</div>';
+
+  try {
+  
+    let html = marked.parse(contentFiles[pageName]);
+    html = html.replace(
+      /<pre><code class="language-mermaid">([\s\S]*?)<\/code><\/pre>/g,
+      '<div class="mermaid">$1</div>'
+    );
+    
+    content.innerHTML = html;
+    
+    const links = content.querySelectorAll('a[href]:not([href^="http"]):not([href^="#"])');
+    links.forEach(link => {
+      const href = link.getAttribute('href');
+      const pageName = href.replace(/^\//, '').replace(/\/$/, '');
+      
+      if (contentFiles[pageName]) {
+        link.onclick = (e) => {
+          e.preventDefault();
+          loadPage(pageName);
+          return false;
+        };
+      }
+    });
+    
+    const mermaidElements = content.querySelectorAll('.mermaid');
+    if (mermaidElements.length > 0) {
+      mermaid.init(undefined, mermaidElements);
+      
+      mermaidElements.forEach(diagram => {
+        diagram.addEventListener('click', function(e) {
+          if (this.classList.contains('zoomed')) {
+            const rect = this.getBoundingClientRect();
+            const isCloseButton = e.clientX > rect.right - 50 && e.clientY < rect.top + 50;
+            
+            if (isCloseButton) {
+              this.classList.remove('zoomed');
+              document.body.style.overflow = '';
+              return;
+            }
+            
+            if (e.target.closest('svg')) return;
+            
+            this.classList.remove('zoomed');
+            document.body.style.overflow = '';
+          } else {
+            if (e.target.tagName === 'A') return;
+            
+            this.classList.add('zoomed');
+            document.body.style.overflow = 'hidden';
+          }
+        });
+      });
+    }
+    
+    window.scrollTo({ top: 0, behavior: 'smooth' });
+    
+  } catch (error) {
+    content.innerHTML = `
+      <div class="loading">
+        <h2>Error</h2>
+        <p>Could not render the page: ${error.message}</p>
+      </div>
+    `;
+  }
+}
+
+async function init() {
+  document.getElementById('content-content').innerHTML = `
+    <div class="loading">
+      <h2>Loading Documentation...</h2>
+      <p>Please wait while we load the vLEI documentation files.</p>
+    </div>
+  `;
+  
+  await loadcontentFiles();
+  
+  const loadedFiles = Object.keys(contentFiles);
+  if (loadedFiles.length > 0) {
+    const startPage = contentFiles['index'] ? 'index' : loadedFiles[0];
+    loadPage(startPage);
+  } else {
+    document.getElementById('content-content').innerHTML = `
+      <div class="loading">
+        <h2>Unable to Load Documentation</h2>
+        <p>No content files could be loaded. Please check that the content files are available in the <code>content/</code> directory.</p>
+        <p><strong>Expected files:</strong> ${knownFiles.join(', ')}</p>
+      </div>
+    `;
+  }
+}
+
+// Keyboard support for zoomed diagrams
+document.addEventListener('keydown', function(e) {
+  if (e.key === 'Escape') {
+    const zoomedDiagram = document.querySelector('.mermaid.zoomed');
+    if (zoomedDiagram) {
+      zoomedDiagram.classList.remove('zoomed');
+      document.body.style.overflow = '';
+    }
+  }
+});
+
+document.addEventListener('DOMContentLoaded', init);
diff --git a/docs/content/credentials.md b/docs/content/credentials.md
new file mode 100644
index 0000000..ac18ee6
--- /dev/null
+++ b/docs/content/credentials.md
@@ -0,0 +1,172 @@
+# Credential Types
+
+The vLEI ecosystem consists of six primary credential types that form a hierarchical trust chain:
+
+## 1. QVI vLEI Credential
+
+- **Schema SAID**: `EBfdlu8R27Fbx-ehrqwImnK-8Cm79sqbAQ4MmvEAYqao`
+- **Issuer**: GLEIF (Global Legal Entity Identifier Foundation)
+- **Recipient**: Qualified vLEI Issuers (QVIs)
+- **Purpose**: Authorizes QVIs to issue Legal Entity vLEI credentials
+- **Key Data**: LEI of the QVI organization, grace period (default 90 days)
+
+## 2. Legal Entity vLEI Credential
+
+- **Schema SAID**: `ENPXp1vQzRF6JwIuS-mp2U8Uf1MoADoP_GqQ62VsDZWY`
+- **Issuer**: Qualified vLEI Issuer (QVI)
+- **Recipient**: Legal Entity (LE)
+- **Purpose**: Establishes the verified legal identity of an organization
+- **Key Data**: LEI of the legal entity, chains to QVI credential
+
+## 3. OOR Authorization vLEI Credential
+
+- **Schema SAID**: `EKA57bKBKxr_kN7iN5i7lMUxpMG-s19dRcmov1iDxz-E`
+- **Issuer**: Legal Entity (LE)
+- **Recipient**: Qualified vLEI Issuer (QVI)
+- **Purpose**: Authorizes QVI to issue Official Organizational Role credentials
+- **Key Data**: Person's AID, role details, chains to LE credential
+
+## 4. Official Organizational Role (OOR) vLEI Credential
+
+- **Schema SAID**: `EBNaNu-M9P5cgrnfl2Fvymy4E_jvxxyjb70PRtiANlJy`
+- **Issuer**: Qualified vLEI Issuer (QVI)
+- **Recipient**: Person/Role Holder
+- **Purpose**: Verifies a person's official role within an organization
+- **Key Data**: Person's legal name, official role title, LEI reference
+
+## 5. ECR vLEI Credential
+
+- **Schema SAID**: `EEy9PkikFcANV1l7EHukCeXqrzT1hNZjGlUk7wuMO5jw`
+- **Issuer**: Qualified vLEI Issuer (QVI)
+- **Recipient**: Person/Role Holder
+- **Purpose**: Verifies a person's engagement context role for specific interactions
+- **Key Data**: Person's legal name, engagement role title, LEI reference, chains to ECR Auth
+
+## 6. ECR Authorization vLEI Credential
+
+- **Schema SAID**: `EH6ekLjSr8V32WyFbGe1zXjTzFs9PkTYmupJ9H65O14g`
+- **Issuer**: Legal Entity (LE)
+- **Recipient**: Qualified vLEI Issuer (QVI)
+- **Purpose**: Authorizes QVI to issue Engagement Context Role credentials
+- **Key Data**: Similar to OOR Auth but for engagement-specific roles
+- **Special Feature**: Includes privacy disclaimer for IPEX/ACDC usage
+
+## Trust Chain Flow
+
+```mermaid
+flowchart TD
+    A[GLEIF<br/>Root Authority] -->|Issues| B[QVI vLEI<br/>Credential]
+    B -->|Authorizes| C[Legal Entity<br/>vLEI Credential]
+    C -->|Enables| D[OOR/ECR<br/>Authorization]
+    D -->|Permits| E[OOR vLEI<br/>Credential]
+    D -->|Permits| F[ECR vLEI<br/>Credential]
+    
+    style A fill:#ff9999
+    style B fill:#99ccff
+    style C fill:#99ff99
+    style D fill:#ffcc99
+    style E fill:#ff99ff
+    style F fill:#ccffcc
+```
+
+## Credential Issuance Sequence
+
+```mermaid
+sequenceDiagram
+    participant GLEIF
+    participant QVI as Qualified vLEI Issuer
+    participant LE as Legal Entity
+    participant Person as Person/Role Holder
+    
+    rect rgb(240, 240, 255)
+        Note over GLEIF,QVI: Foundation Layer
+        GLEIF->>QVI: Issue QVI vLEI Credential
+        Note right of QVI: Schema: EBfdlu8R27Fbx-ehrqwImnK-8Cm79sqbAQ4MmvEAYqao
+        Note right of QVI: Contains LEI, grace period
+    end
+    
+    rect rgb(240, 255, 240)
+        Note over QVI,LE: Legal Entity Layer
+        QVI->>LE: Issue LE vLEI Credential
+        Note right of LE: Schema: ENPXp1vQzRF6JwIuS-mp2U8Uf1MoADoP_GqQ62VsDZWY
+        Note right of LE: Chains to QVI credential
+        Note right of LE: Contains entity LEI
+    end
+    
+    rect rgb(255, 240, 240)
+        Note over LE,QVI: Authorization Layer
+        LE->>QVI: Issue OOR Authorization
+        Note left of QVI: Schema: EKA57bKBKxr_kN7iN5i7lMUxpMG-s19dRcmov1iDxz-E
+        Note left of QVI: Authorizes OOR
+        
+        LE->>QVI: Issue ECR Authorization
+        Note left of QVI: Schema: EH6ekLjSr8V32WyFbGe1zXjTzFs9PkTYmupJ9H65O14g
+        Note left of QVI: Authorizes ECR
+    end
+    
+    rect rgb(255, 255, 240)
+        Note over QVI,Person: Role Credential Layer
+        QVI->>Person: Issue OOR vLEI Credential
+        Note right of Person: Schema: EBNaNu-M9P5cgrnfl2Fvymy4E_jvxxyjb70PRtiANlJy
+        Note right of Person: Official organizational role
+        Note right of Person: Chains to OOR Auth
+        
+        QVI->>Person: Issue ECR vLEI Credential
+        Note right of Person: Schema: EEy9PkikFcANV1l7EHukCeXqrzT1hNZjGlUk7wuMO5jw
+        Note right of Person: Engagement context role
+        Note right of Person: Chains to ECR Auth
+    end
+```
+
+## Key Architecture Features
+
+### Credential Chaining
+
+- Each credential (except QVI) contains edges that reference its authorizing chained credential
+- Creates a verifiable chain of authority from GLEIF down to individual roles9
+- Enables cryptographic verification of the entire trust chain
+
+### SAID-Based References
+
+- All credential components use Self-Addressing Identifiers (SAIDs)
+- Attributes and Rules can be either full objects or SAID string references
+- Enables efficient storage and transmission while maintaining integrity
+
+### Common Structure
+
+All vLEI credentials share a common ACDC structure:
+
+- **v**: Version string
+- **d**: Credential SAID
+- **u**: One-time use nonce (privacy-preserving metadata)
+- **i**: Issuer AID
+- **ri**: Credential status registry
+- **s**: Schema SAID
+- **a**: Attributes (content-specific)
+- **e**: Edges (chaining relationships)
+- **r**: Rules (usage and issuance disclaimers)
+
+### Authorization Pattern
+
+- Legal Entities issue authorization credentials to QVIs
+- QVIs then issue role credentials to individuals
+- Separates official roles (OOR) from engagement context roles (ECR)
+- ECR includes additional privacy considerations for IPEX/ACDC usage
+
+## Verification Process
+
+To verify any credential in the ecosystem:
+
+1. **Validate the credential structure** against its schema SAID
+2. **Verify the issuer signature** using KERI
+3. **Check the credential status** via an Observor deployemt monitoring Transaction Event Log staus
+4. **Follow the edge references** to validate the chain of authority
+5. **Verify each directed edge (chained credential)** recursively up to GLEIF
+
+## Use Cases
+
+- **Supply Chain Verification**: Verify the legal identity of trading partners
+- **Digital Identity**: Establish organizational roles for digital interactions  
+- **Regulatory Compliance**: Provide cryptographic proof of organizational authority
+- **Selective Disclosure**: Share only necessary identity attributes
+- **Cross-Border Commerce**: Enable trusted international business relationships
diff --git a/docs/content/ecr-auth-credential-schema.md b/docs/content/ecr-auth-credential-schema.md
new file mode 100644
index 0000000..d3dbc29
--- /dev/null
+++ b/docs/content/ecr-auth-credential-schema.md
@@ -0,0 +1,125 @@
+# ECR Authorization vLEI Credential Schema
+
+## Schema Details
+
+The ECR Authorization credential is issued by Legal Entities to QVIs, authorizing them to issue ECR credentials for specific engagement context roles within the organization.
+
+- **Schema SAID**: `EH6ekLjSr8V32WyFbGe1zXjTzFs9PkTYmupJ9H65O14g`
+- **Version**: 1.0.0
+- **Issuer**: Legal Entity
+- **Holder**: Qualified vLEI Issuer (QVI)
+- **Purpose**: Authorize ECR credential issuance for engagement context roles
+
+## Key Characteristics
+
+- **Engagement-Specific**: For temporary, project-based, or consultancy roles
+- **Person Specification**: Includes AID and legal name of intended recipient
+- **Role Description**: Specifies the engagement context role
+- **Privacy Considerations**: Includes privacy disclaimer for IPEX/ACDC usage
+- **Edge Chaining**: Links to Legal Entity's vLEI credential
+
+## Authorization Flow
+
+### Issuance Process
+
+```mermaid
+sequenceDiagram
+    participant LE as Legal Entity
+    participant QVI as QVI
+    participant Person as Person
+
+    rect rgb(240, 255, 240)
+        Note over LE,QVI: ECR Authorization Flow
+        LE->>QVI: Issue ECR Authorization
+        Note over QVI: Schema: EH6ekLjSr8V32WyFbGe1zXjTzFs9PkTYmupJ9H65O14g
+        Note over QVI: Authorizes engagement context role issuance
+        Note over QVI: Includes privacy disclaimer
+    end
+    
+    rect rgb(255, 240, 240)
+        Note over QVI,Person: Credential Issuance
+        QVI->>Person: Issue ECR Credential
+        Note over Person: Based on received authorization
+    end
+```
+
+## Rules and Disclaimers
+
+The ECR Authorization credential includes three disclaimer types:
+
+- **Usage Disclaimer**: Legal language about credential usage rights and limitations
+- **Issuance Disclaimer**: Terms and conditions for credential issuance
+- **Privacy Disclaimer**: Privacy considerations for IPEX/ACDC usage (unique to ECR Auth)
+
+The privacy disclaimer is specific to ECR Authorization credentials, acknowledging that engagement context roles may involve external parties requiring additional privacy protections.
+
+```mermaid
+classDiagram
+    class ECRAuthvLEICredential {
+        +string v : Version
+        +string d : Credential SAID
+        +string u : One time use nonce
+        +string i : LE Issuer AID
+        +string ri : Credential status registry
+        +string s : Schema SAID
+        +a : Attributes
+        +e : Edges
+        +r : Rules
+    }
+
+    class ECRAuthAttributes {
+        +string d : Attributes block SAID
+        +string i : QVI Issuee AID
+        +string dt : Issuance date time
+        +string AID : Recipient AID
+        +string LEI : Legal Entity Identifier
+        +string personLegalName : Recipient name
+        +string engagementContextRole : Role description
+    }
+
+    class ECRAuthEdges {
+        +string d : Edges block SAID
+        +LENode le : Legal Entity reference
+    }
+
+    class LENode {
+        +string n : LE credential SAID
+        +string s : Required schema SAID
+        +string o : Operator (I2I)
+    }
+
+    class ECRAuthRules {
+        +string d : Rules block SAID
+        +UsageDisclaimer usageDisclaimer
+        +IssuanceDisclaimer issuanceDisclaimer
+        +PrivacyDisclaimer privacyDisclaimer
+    }
+
+    class UsageDisclaimer {
+        +string l : Legal language
+    }
+
+    class IssuanceDisclaimer {
+        +string l : Legal language
+    }
+
+    class PrivacyDisclaimer {
+        +string l : Privacy considerations text
+    }
+
+    ECRAuthvLEICredential --> "1" ECRAuthAttributes : contains
+    ECRAuthvLEICredential --> "1" ECRAuthEdges : contains
+    ECRAuthvLEICredential --> "1" ECRAuthRules : contains
+    ECRAuthEdges --> "1" LENode : references
+    ECRAuthRules --> "1" UsageDisclaimer : has
+    ECRAuthRules --> "1" IssuanceDisclaimer : has
+    ECRAuthRules --> "1" PrivacyDisclaimer : has
+
+    note for ECRAuthvLEICredential "Schema ID: EH6ekLjSr8V32WyFbGe1zXjTzFs9PkTYmupJ9H65O14g\nVersion: 1.0.0\nIssued by LE to QVI\nAuthorizes ECR credential issuance"
+    
+    note for ECRAuthAttributes "Required fields:\ni (QVI AID), dt, AID (Person),\nLEI, personLegalName, engagementContextRole"
+    
+    note for LENode "Links to LE credential\nSchema: ENPXp1vQzRF6JwIuS-mp2U8Uf1MoADoP_GqQ62VsDZWY\nOperator: I2I (issuer to issuer)"
+    
+    note for PrivacyDisclaimer "ECR Auth includes privacy\nconsiderations for IPEX/ACDC usage"
+```
diff --git a/docs/content/ecr-credential-schema.md b/docs/content/ecr-credential-schema.md
new file mode 100644
index 0000000..db3a293
--- /dev/null
+++ b/docs/content/ecr-credential-schema.md
@@ -0,0 +1,107 @@
+# Engagement Context Role (ECR) vLEI Credential Schema
+
+## Schema Details
+
+The ECR vLEI credential represents engagement context roles for individuals operating in specific project or consultancy contexts within or on behalf of a legal entity.
+
+- **Schema SAID**: `EEy9PkikFcANV1l7EHukCeXqrzT1hNZjGlUk7wuMO5jw`
+- **Version**: 1.0.0
+- **Issuer**: Qualified vLEI Issuer (QVI)
+- **Holder**: Individual with engagement context role
+- **Authorization Required**: ECR Auth credential from Legal Entity
+
+## Key Characteristics
+
+- **Context-Specific**: For temporary or project-based engagements
+- **Flexible Roles**: Uses `engagementContextRole` field for role description
+- **Authorization Chain**: Requires ECR Auth from Legal Entity to QVI
+- **LEI Binding**: Tied to organization's Legal Entity Identifier
+- **Use Cases**: Consultancy, contractor roles, project teams, external engagements
+
+## Authorization Reference
+
+The ECR vLEI Credential requires an ECR Authorization credential from the Legal Entity. This authorization allows the QVI to issue ECR credentials for specific engagement contexts.
+
+- **Auth Schema SAID**: `EH6ekLjSr8V32WyFbGe1zXjTzFs9PkTYmupJ9H65O14g`
+- **Auth Type**: Issuer-to-Issuer (I2I)
+- See [ECR Auth Credential Schema](ecr-auth-credential-schema) for details
+
+## Issuance Process
+
+```mermaid
+sequenceDiagram
+    participant LE as Legal Entity
+    participant QVI as QVI
+    participant Person as Person
+
+    LE->>QVI: Issue ECR Authorization
+    Note over QVI: See ECR Auth Schema documentation
+    
+    QVI->>Person: Issue ECR vLEI Credential
+    Note over Person: Schema: EEy9PkikFcANV1l7EHukCeXqrzT1hNZjGlUk7wuMO5jw
+    Note over Person: Chains to ECR Auth via edges.auth
+```
+
+```mermaid
+classDiagram
+    class ECRvLEICredential {
+        +string v : Version
+        +string d : Credential SAID
+        +string u : One time use nonce
+        +string i : QVI Issuer AID
+        +string ri : Credential status registry
+        +string s : Schema SAID
+        +a : Attributes
+        +e : Edges
+        +r : Rules
+    }
+
+    class Attributes {
+        +string d : Attributes block SAID
+        +string i : Person Issuee AID
+        +string dt : Issuance date time
+        +string LEI : Legal Entity Identifier
+        +string personLegalName : Recipient name
+        +string engagementContextRole : Engagement role title
+    }
+
+    class Edges {
+        +string d : Edges block SAID
+        +AuthNode auth : Authorization chain
+    }
+
+    class AuthNode {
+        +string n : ACDC SAID reference
+        +string s : Required schema SAID
+        +string o : Operator (I2I)
+    }
+
+    class Rules {
+        +string d : Rules block SAID
+        +UsageDisclaimer usageDisclaimer
+        +IssuanceDisclaimer issuanceDisclaimer
+    }
+
+    class UsageDisclaimer {
+        +string l : Legal language about usage
+    }
+
+    class IssuanceDisclaimer {
+        +string l : Legal language about issuance
+    }
+
+    ECRvLEICredential --> "1" Attributes : contains
+    ECRvLEICredential --> "1" Edges : contains
+    ECRvLEICredential --> "1" Rules : contains
+    Edges --> "1" AuthNode : references
+    Rules --> "1" UsageDisclaimer : has
+    Rules --> "1" IssuanceDisclaimer : has
+
+    note for ECRvLEICredential "Schema ID: EEy9PkikFcANV1l7EHukCeXqrzT1hNZjGlUk7wuMO5jw\nVersion: 1.0.0\nIssued by QVI to Engagement Context Representatives"
+    
+    note for Attributes "Required fields:\ni, dt, LEI, personLegalName, engagementContextRole"
+    
+    note for AuthNode "Links to ECR Auth credential\nSchema: EH6ekLjSr8V32WyFbGe1zXjTzFs9PkTYmupJ9H65O14g\nOperator: I2I (issuer to issuer)"
+    
+    note for Rules "Standard vLEI disclaimers\nSame as other vLEI credentials"
+```
diff --git a/docs/content/index.md b/docs/content/index.md
new file mode 100644
index 0000000..9401f18
--- /dev/null
+++ b/docs/content/index.md
@@ -0,0 +1,40 @@
+# vLEI Ecosystem Credential Documentation
+
+This documentation covers the implementation of the GLEIF vLEI ecosystem using KERI (Key Event Receipt Infrastructure) and ACDC (Authentic Chained Data Containers).
+
+### Overview
+
+- [Credentials types](credentials) - Introduction to the credential types and their relationships
+- [vLEI Credential Ecosystem](vlei-credential-ecosystem) - Detailed ecosystem architecture and workflows
+- [Dependency Graph](vlei-dependency-graph) - Visual representation of credential dependencies
+
+### Credential Schemas
+
+- [Legal Entity Credential](/legal-entity-credential-schema) - LE credential schema details
+- [QVI Credential](/qvi-credential-schema/) - Qualified vLEI Issuer credential schema
+- [OOR Auth Credential](/oor-auth-credential-schema/) - Official Organizational Role Authorization credential schema
+- [OOR Credential](/oor-credential-schema/) - Official Organizational Role credential schema
+- [ECR Auth Credential](/ecr-auth-credential-schema/) - Engagement Context Role Authorization credential schema
+- [ECR Credential](/ecr-credential-schema/) - Engagement Context Role credential schema
+
+## Quick Start
+
+The vLEI ecosystem implements a hierarchical trust model for organizational identity verification:
+
+1. **Root of Trust**: GLEIF as the global authority
+2. **QVIs**: Qualified vLEI Issuers authorized by GLEIF
+3. **Legal Entities**: Organizations with vLEI credentials
+4. **Role Holders**: Individuals with official organizational roles
+
+## Key Features
+
+- **Cryptographic Verification**: All credentials are cryptographically end verifiable using KERI
+- **Chain of Authority**: Clear delegation chains from GLEIF to individual role holders
+- **Privacy-Preserving**: Selective disclosure and compact credentials
+- **Revocation Support**: Transaction Event Logs capture issuance state
+
+## Additional Resources
+
+- [KERI Specification](https://trustoverip.github.io/tswg-keri-specification/)
+- [ACDC Specification](https://trustoverip.github.io/tswg-acdc-specification/)
+- [CESR Specification](https://trustoverip.github.io/tswg-cesr-specification/)
diff --git a/docs/content/legal-entity-credential-schema.md b/docs/content/legal-entity-credential-schema.md
new file mode 100644
index 0000000..be84364
--- /dev/null
+++ b/docs/content/legal-entity-credential-schema.md
@@ -0,0 +1,79 @@
+# Legal Entity vLEI Credential Schema
+
+## Schema Details
+
+The Legal Entity vLEI credential is issued by QVIs to organizations with valid Legal Entity Identifiers. This credential serves as the foundation for role-based credentials within an organization.
+
+- **Schema SAID**: `ENPXp1vQzRF6JwIuS-mp2U8Uf1MoADoP_GqQ62VsDZWY`
+- **Version**: 1.0.0
+- **Issuer**: Qualified vLEI Issuer (QVI)
+- **Holder**: Legal Entity (organization with LEI)
+
+## Key Characteristics
+
+- **LEI Verification**: Requires valid and active Legal Entity Identifier
+- **QVI Chain**: Must be chained to issuer's QVI credential from GLEIF
+- **Status Registry**: Transaction Event Log maintains issuance status
+- **Edge References**: Cryptographically links to parent QVI credential
+- **Foundation Credential**: Enables issuance of OOR and ECR Auth credentials
+
+```mermaid
+classDiagram
+    class LegalEntityvLEICredential {
+        +string v : Version
+        +string d : Credential SAID
+        +string u : One time use nonce
+        +string i : QVI Issuer AID
+        +string ri : Credential status registry
+        +string s : Schema SAID
+        +a : Attributes
+        +e : Edges
+        +r : Rules
+    }
+
+    class Attributes {
+        +string d : Attributes block SAID
+        +string i : LE Issuer AID
+        +string dt : Issuance date time
+        +string LEI : Legal Entity Identifier
+    }
+
+    class Edges {
+        +string d : Edges block SAID
+        +QVINode qvi : QVI reference
+    }
+
+    class QVINode {
+        +string n : Issuer credential SAID
+        +string s : Required schema SAID
+    }
+
+    class Rules {
+        +string d : Rules block SAID
+        +UsageDisclaimer usageDisclaimer
+        +IssuanceDisclaimer issuanceDisclaimer
+    }
+
+    class UsageDisclaimer {
+        +string l : Legal language about usage
+    }
+
+    class IssuanceDisclaimer {
+        +string l : Legal language about issuance
+    }
+
+    LegalEntityvLEICredential --> "1" Attributes : contains
+    LegalEntityvLEICredential --> "1" Edges : contains
+    LegalEntityvLEICredential --> "1" Rules : contains
+    Edges --> "1" QVINode : references
+    Rules --> "1" UsageDisclaimer : has
+    Rules --> "1" IssuanceDisclaimer : has
+
+    note for LegalEntityvLEICredential "Schema ID: ENPXp1vQzRF6JwIuS-mp2U8Uf1MoADoP_GqQ62VsDZWY\nVersion: 1.0.0\nIssued by QVI to Legal Entity"
+    
+    note for Attributes "Can be either:\n- SAID string reference\n- Full object with properties\nRequired: i, dt, LEI"
+    
+    note for Edges "Links to QVI credential\nSchema: EBfdlu8R27Fbx-ehrqwImnK-8Cm79sqbAQ4MmvEAYqao"
+    
+    note for Rules "Can be either:\n- SAID string reference\n- Full object with disclaimers"
+```
diff --git a/docs/content/oor-auth-credential-schema.md b/docs/content/oor-auth-credential-schema.md
new file mode 100644
index 0000000..ddfb06d
--- /dev/null
+++ b/docs/content/oor-auth-credential-schema.md
@@ -0,0 +1,115 @@
+# OOR Authorization vLEI Credential Schema
+
+## Schema Details
+
+The OOR Authorization credential is issued by Legal Entities to QVIs, authorizing them to issue OOR credentials for official organizational roles within the organization.
+
+- **Schema SAID**: `EKA57bKBKxr_kN7iN5i7lMUxpMG-s19dRcmov1iDxz-E`
+- **Version**: 1.0.0
+- **Issuer**: Legal Entity
+- **Holder**: Qualified vLEI Issuer (QVI)
+- **Purpose**: Authorize OOR credential issuance for official organizational roles
+
+## Key Characteristics
+
+- **Official Positions**: For permanent, formal organizational roles (CEO, CFO, Director, Manager)
+- **Person Specification**: Includes AID and legal name of intended recipient
+- **Role Description**: Specifies the official organizational role
+- **Formal Hierarchy**: Represents official organizational structure
+- **Edge Chaining**: Links to Legal Entity's vLEI credential
+
+## Authorization Flow
+
+### Issuance Process
+
+```mermaid
+sequenceDiagram
+    participant LE as Legal Entity
+    participant QVI as QVI
+    participant Person as Person
+
+    rect rgb(240, 240, 255)
+        Note over LE,QVI: OOR Authorization Flow
+        LE->>QVI: Issue OOR Authorization
+        Note over QVI: Schema: EKA57bKBKxr_kN7iN5i7lMUxpMG-s19dRcmov1iDxz-E
+        Note over QVI: Authorizes official role issuance
+    end
+    
+    rect rgb(255, 240, 240)
+        Note over QVI,Person: Credential Issuance
+        QVI->>Person: Issue OOR Credential
+        Note over Person: Based on received authorization
+    end
+```
+
+## Rules and Disclaimers
+
+The OOR Authorization credential includes two disclaimer types:
+
+- **Usage Disclaimer**: Legal language about credential usage rights and limitations
+- **Issuance Disclaimer**: Terms and conditions for credential issuance
+
+Note: Unlike ECR Authorization, OOR Authorization does not include a privacy disclaimer as it is intended for official organizational roles that are typically public.
+
+```mermaid
+classDiagram
+    class OORAuthvLEICredential {
+        +string v : Version
+        +string d : Credential SAID
+        +string u : One time use nonce
+        +string i : LE Issuer AID
+        +string ri : Credential status registry
+        +string s : Schema SAID
+        +a : Attributes
+        +e : Edges
+        +r : Rules
+    }
+
+    class OORAuthAttributes {
+        +string d : Attributes block SAID
+        +string i : QVI Issuee AID
+        +string dt : Issuance date time
+        +string AID : Recipient AID
+        +string LEI : Legal Entity Identifier
+        +string personLegalName : Recipient name
+        +string officialRole : Role description
+    }
+
+    class OORAuthEdges {
+        +string d : Edges block SAID
+        +LENode le : Legal Entity reference
+    }
+
+    class LENode {
+        +string n : LE credential SAID
+        +string s : Required schema SAID
+        +string o : Operator (I2I)
+    }
+
+    class OORAuthRules {
+        +string d : Rules block SAID
+        +UsageDisclaimer usageDisclaimer
+        +IssuanceDisclaimer issuanceDisclaimer
+    }
+
+    class UsageDisclaimer {
+        +string l : Legal language
+    }
+
+    class IssuanceDisclaimer {
+        +string l : Legal language
+    }
+
+    OORAuthvLEICredential --> "1" OORAuthAttributes : contains
+    OORAuthvLEICredential --> "1" OORAuthEdges : contains
+    OORAuthvLEICredential --> "1" OORAuthRules : contains
+    OORAuthEdges --> "1" LENode : references
+    OORAuthRules --> "1" UsageDisclaimer : has
+    OORAuthRules --> "1" IssuanceDisclaimer : has
+
+    note for OORAuthvLEICredential "Schema ID: EKA57bKBKxr_kN7iN5i7lMUxpMG-s19dRcmov1iDxz-E\nVersion: 1.0.0\nIssued by LE to QVI\nAuthorizes OOR credential issuance"
+    
+    note for OORAuthAttributes "Required fields:\ni (QVI AID), dt, AID (Person),\nLEI, personLegalName, officialRole"
+    
+    note for LENode "Links to LE credential\nSchema: ENPXp1vQzRF6JwIuS-mp2U8Uf1MoADoP_GqQ62VsDZWY\nOperator: I2I (issuer to issuer)"
+```
diff --git a/docs/content/oor-credential-schema.md b/docs/content/oor-credential-schema.md
new file mode 100644
index 0000000..6f3c3ef
--- /dev/null
+++ b/docs/content/oor-credential-schema.md
@@ -0,0 +1,107 @@
+# Legal Entity Official Organizational Role (OOR) vLEI Credential Schema
+
+## Schema Details
+
+The OOR vLEI credential represents official organizational roles within a legal entity. These credentials are issued by QVIs to individuals holding formal positions in an organization.
+
+- **Schema SAID**: `EBNaNu-M9P5cgrnfl2Fvymy4E_jvxxyjb70PRtiANlJy`
+- **Version**: 1.0.0
+- **Issuer**: Qualified vLEI Issuer (QVI)
+- **Holder**: Individual with official organizational role
+- **Authorization Required**: OOR Auth credential from Legal Entity
+
+## Key Characteristics
+
+- **Official Positions**: For formal organizational roles (CEO, CFO, Director, etc.)
+- **LEI Binding**: Tied to organization's Legal Entity Identifier
+- **Authorization Chain**: Requires OOR Auth from Legal Entity to QVI
+- **Person Identification**: Links to individual's Autonomic Identifier (AID)
+- **Role Specificity**: Uses `officialRole` field for position title
+
+## Authorization Reference
+
+The OOR vLEI Credential requires an OOR Authorization credential from the Legal Entity. This authorization allows the QVI to issue OOR credentials on behalf of the organization.
+
+- **Auth Schema SAID**: `EKA57bKBKxr_kN7iN5i7lMUxpMG-s19dRcmov1iDxz-E`
+- **Auth Type**: Issuer-to-Issuer (I2I) delegation
+- See [OOR Auth Credential Schema](oor-auth-credential-schema) for details
+
+## Issuance Process
+
+```mermaid
+sequenceDiagram
+    participant LE as Legal Entity
+    participant QVI as QVI
+    participant Person as Person
+
+    LE->>QVI: Issue OOR Authorization
+    Note over QVI: See OOR Auth Schema documentation
+    
+    QVI->>Person: Issue OOR vLEI Credential
+    Note over Person: Schema: EBNaNu-M9P5cgrnfl2Fvymy4E_jvxxyjb70PRtiANlJy
+    Note over Person: Chains to OOR Auth via edges.auth
+```
+
+```mermaid
+classDiagram
+    class OORvLEICredential {
+        +string v : Version
+        +string d : Credential SAID
+        +string u : One time use nonce
+        +string i : QVI Issuer AID
+        +string ri : Credential status registry
+        +string s : Schema SAID
+        +a : Attributes
+        +e : Edges
+        +r : Rules
+    }
+
+    class Attributes {
+        +string d : Attributes block SAID
+        +string i : Person Issuee AID
+        +string dt : Issuance date time
+        +string LEI : Legal Entity Identifier
+        +string personLegalName : Recipient name
+        +string officialRole : Official role title
+    }
+
+    class Edges {
+        +string d : Edges block SAID
+        +AuthNode auth : Authorization chain
+    }
+
+    class AuthNode {
+        +string n : ACDC SAID reference
+        +string s : Required schema SAID
+        +string o : Operator (I2I)
+    }
+
+    class Rules {
+        +string d : Rules block SAID
+        +UsageDisclaimer usageDisclaimer
+        +IssuanceDisclaimer issuanceDisclaimer
+    }
+
+    class UsageDisclaimer {
+        +string l : Legal language about usage
+    }
+
+    class IssuanceDisclaimer {
+        +string l : Legal language about issuance
+    }
+
+    OORvLEICredential --> "1" Attributes : contains
+    OORvLEICredential --> "1" Edges : contains
+    OORvLEICredential --> "1" Rules : contains
+    Edges --> "1" AuthNode : references
+    Rules --> "1" UsageDisclaimer : has
+    Rules --> "1" IssuanceDisclaimer : has
+
+    note for OORvLEICredential "Schema ID: EBNaNu-M9P5cgrnfl2Fvymy4E_jvxxyjb70PRtiANlJy\nVersion: 1.0.0\nIssued by QVI to Official Representatives"
+    
+    note for Attributes "Required fields:\ni, dt, LEI, personLegalName, officialRole"
+    
+    note for AuthNode "Links to Auth credential\nSchema: EKA57bKBKxr_kN7iN5i7lMUxpMG-s19dRcmov1iDxz-E\nOperator: I2I (issuer to issuer)"
+    
+    note for Rules "Standard vLEI disclaimers\nSame as other vLEI credentials"
+```
diff --git a/docs/content/qvi-credential-schema.md b/docs/content/qvi-credential-schema.md
new file mode 100644
index 0000000..fc0a7aa
--- /dev/null
+++ b/docs/content/qvi-credential-schema.md
@@ -0,0 +1,64 @@
+# Qualified vLEI Issuer (QVI) Credential Schema
+
+## Schema Details
+
+The QVI credential is the foundational credential in the vLEI ecosystem, issued directly by GLEIF to Qualified vLEI Issuers. This credential authorizes QVIs to issue Legal Entity vLEI credentials to organizations.
+
+- **Schema SAID**: `EBfdlu8R27Fbx-ehrqwImnK-8Cm79sqbAQ4MmvEAYqao`
+- **Version**: 1.0.0
+- **Issuer**: GLEIF (Global Legal Entity Identifier Foundation)
+- **Holder**: Qualified vLEI Issuer (QVI)
+
+## Key Characteristics
+
+- **Direct GLEIF Issuance**: Only GLEIF can issue QVI credentials
+- **Delegation**: GLEIF MUST delegate the QVI AID
+- **LEI Requirement**: QVI must have a valid Legal Entity Identifier
+- **Status Registry**: Transaction Event Log maintains issuance status
+
+```mermaid
+classDiagram
+    class QualifiedvLEIIssuerCredential {
+        +string v : Version
+        +string d : Credential SAID
+        +string u : One time use nonce
+        +string i : GLEIF Issuee AID
+        +string ri : Credential status registry
+        +string s : Schema SAID
+        +a : Attributes
+        +r : Rules
+    }
+
+    class Attributes {
+        +string d : Attributes block SAID
+        +string i : QVI Issuee AID
+        +string dt : Issuance date time
+        +string LEI : LEI of Legal Entity
+        +int gracePeriod : Allocated grace period (default: 90)
+    }
+
+    class Rules {
+        +string d : Rules block SAID
+        +UsageDisclaimer usageDisclaimer
+        +IssuanceDisclaimer issuanceDisclaimer
+    }
+
+    class UsageDisclaimer {
+        +string l : Legal language about usage
+    }
+
+    class IssuanceDisclaimer {
+        +string l : Legal language about issuance
+    }
+
+    QualifiedvLEIIssuerCredential --> "1" Attributes : contains
+    QualifiedvLEIIssuerCredential --> "1" Rules : contains
+    Rules --> "1" UsageDisclaimer : has
+    Rules --> "1" IssuanceDisclaimer : has
+
+    note for QualifiedvLEIIssuerCredential "Schema ID: EBfdlu8R27Fbx-ehrqwImnK-8Cm79sqbAQ4MmvEAYqao\nVersion: 1.0.0\nIssued by GLEIF to QVIs"
+    
+    note for Attributes "Can be either:\n- SAID string reference\n- Full object with properties\nRequired: i, dt, LEI"
+    
+    note for Rules "Can be either:\n- SAID string reference\n- Full object with disclaimers"
+```
diff --git a/docs/content/vlei-credential-ecosystem.md b/docs/content/vlei-credential-ecosystem.md
new file mode 100644
index 0000000..7368451
--- /dev/null
+++ b/docs/content/vlei-credential-ecosystem.md
@@ -0,0 +1,200 @@
+# vLEI Credential Ecosystem - Dependencies and Schema Relationships
+
+```mermaid
+classDiagram
+    class QVICredential {
+        +string v : Version
+        +string d : Credential SAID
+        +string u : One time use nonce
+        +string i : GLEIF Issuee AID
+        +string ri : Credential status registry
+        +string s : Schema SAID
+        +Attributes a : Attributes block
+        +Rules r : Rules block
+    }
+    class LECredential {
+        +string v : Version
+        +string d : Credential SAID
+        +string u : One time use nonce
+        +string i : QVI Issuer AID
+        +string ri : Credential status registry
+        +string s : Schema SAID
+        +Attributes a : Attributes block
+        +Edges e : Edges block
+        +Rules r : Rules block
+    }
+    class OORCredential {
+        +string v : Version
+        +string d : Credential SAID
+        +string u : One time use nonce
+        +string i : QVI Issuer AID
+        +string ri : Credential status registry
+        +string s : Schema SAID
+        +Attributes a : Attributes block
+        +Edges e : Edges block
+        +Rules r : Rules block
+    }
+    class OORAuthCredential {
+        +string v : Version
+        +string d : Credential SAID
+        +string u : One time use nonce
+        +string i : LE Issuer AID
+        +string ri : Credential status registry
+        +string s : Schema SAID
+        +Attributes a : Attributes block
+        +Edges e : Edges block
+        +Rules r : Rules block
+    }
+    class ECRAuthCredential {
+        +string v : Version
+        +string d : Credential SAID
+        +string u : One time use nonce
+        +string i : LE Issuer AID
+        +string ri : Credential status registry
+        +string s : Schema SAID
+        +Attributes a : Attributes block
+        +Edges e : Edges block
+        +Rules r : Rules block
+    }
+    class QVIAttributes {
+        +string i : QVI Issuee AID
+        +string dt : Issuance date time
+        +string LEI : LEI of the requesting Legal Entity
+        +int gracePeriod : Allocated grace period
+    }
+    class LEAttributes {
+        +string i : LE Issuer AID
+        +string dt : issuance date time
+        +string LEI : LE Issuer AID
+    }
+    class OORAttributes {
+        +string i : Person Issuee AID
+        +string dt : Issuance date time
+        +string LEI : LEI of the Legal Entity
+        +string personLegalName : Recipient name as provided during identity assurance
+        +string officialRole : Official role title
+    }
+    class AuthAttributes {
+        +string i : QVI Issuee AID
+        +string dt : Issuance date time
+        +string AID : AID of the intended recipient of the ECR credential
+        +string LEI : LEI of the requesting Legal Entity
+        +string personLegalName : Requested recipient name as provided during identity assurance
+        +string role : Requested role description
+    }
+    class QVIEdge {
+        +string n : Issuer credential SAID
+        +string s : SAID of required schema of the credential pointed to by this node
+    }
+    class LEEdge {
+        +string n : Issuer credential SAID
+        +string s : SAID of required schema of the credential pointed to by this node
+    }
+    class AuthEdge {
+        +string n : Issuer credential SAID
+        +string s : SAID of required schema of the credential pointed to by this node
+        +string o : Operator for this edge
+    }
+    class Rules {
+        +UsageDisclaimer usageDisclaimer : Usage Disclaimer
+        +IssuanceDisclaimer issuanceDisclaimer : Issuance Disclaimer
+        +PrivacyDisclaimer privacyDisclaimer : Privacy Disclaimer
+    }
+    QVICredential --> QVIAttributes : contains
+    QVICredential --> Rules : has
+    LECredential --> LEAttributes : contains
+    LECredential --> QVIEdge : chains to
+    LECredential --> Rules : has
+    OORCredential --> OORAttributes : contains
+    OORCredential --> AuthEdge : authorized by
+    OORCredential --> Rules : has
+    OORAuthCredential --> AuthAttributes : contains
+    OORAuthCredential --> LEEdge : chains to
+    OORAuthCredential --> Rules : has
+    ECRAuthCredential --> AuthAttributes : contains
+    ECRAuthCredential --> LEEdge : chains to
+    ECRAuthCredential --> Rules : has
+    LECredential ..> QVICredential : requires - QVI must exist
+    OORCredential ..> OORAuthCredential : requires - needs authorization
+    OORAuthCredential ..> LECredential : requires - LE must exist
+    ECRAuthCredential ..> LECredential : requires - LE must exist
+    note for QVICredential "QVI vLEI Credential<br/>Schema: EBfdlu8R27Fbx-ehrqwImnK-8Cm79sqbAQ4MmvEAYqao<br/>Issued by: GLEIF → QVI"
+    note for LECredential "Legal Entity vLEI Credential<br/>Schema: ENPXp1vQzRF6JwIuS-mp2U8Uf1MoADoP_GqQ62VsDZWY<br/>Issued by: QVI → LE"
+    note for OORCredential "Official Organizational Role<br/>Schema: EBNaNu-M9P5cgrnfl2Fvymy4E_jvxxyjb70PRtiANlJy<br/>Issued by: QVI → Person"
+    note for OORAuthCredential "OOR Authorization<br/>Schema: EKA57bKBKxr_kN7iN5i7lMUxpMG-s19dRcmov1iDxz-E<br/>Issued by: LE → QVI"
+    note for ECRAuthCredential "ECR Authorization<br/>Schema: EH6ekLjSr8V32WyFbGe1zXjTzFs9PkTYmupJ9H65O14g<br/>Issued by: LE → QVI"
+
+```
+
+## Credential Issuance Flow
+
+```mermaid
+sequenceDiagram
+    participant GLEIF
+    participant QVI as Qualified vLEI Issuer
+    participant LE as Legal Entity
+    participant Person as Person/Role Holder
+    
+    rect rgb(240, 240, 255)
+        Note over GLEIF,QVI: Foundation Layer
+        GLEIF->>QVI: Issue QVI vLEI Credential
+        Note right of QVI: Schema: EBfdlu8R27Fbx-ehrqwImnK-8Cm79sqbAQ4MmvEAYqao
+    end
+    
+    rect rgb(240, 255, 240)
+        Note over QVI,LE: Legal Entity Layer
+        QVI->>LE: Issue LE vLEI Credential
+        Note right of LE: Schema: ENPXp1vQzRF6JwIuS-mp2U8Uf1MoADoP_GqQ62VsDZWY
+        Note right of LE: Chains to QVI credential
+    end
+    
+    rect rgb(255, 240, 240)
+        Note over LE,Person: Authorization Layer
+        LE->>QVI: Issue OOR Authorization
+        Note left of QVI: Schema: EKA57bKBKxr_kN7iN5i7lMUxpMG-s19dRcmov1iDxz-E
+        Note left of QVI: Authorizes OOR
+        
+        LE->>QVI: Issue ECR Authorization
+        Note left of QVI: Schema: EH6ekLjSr8V32WyFbGe1zXjTzFs9PkTYmupJ9H65O14g
+        Note left of QVI: Authorizes ECR
+    end
+    
+    rect rgb(255, 255, 240)
+        Note over QVI,Person: Role Credential Layer
+        QVI->>Person: Issue OOR vLEI Credential
+        Note right of Person: Schema: EBNaNu-M9P5cgrnfl2Fvymy4E_jvxxyjb70PRtiANlJy
+        Note right of Person: Chains to OOR Auth
+        QVI->>Person: Issue ECR vLEI Credential
+        Note right of Person: Schema: EEEy9PkikFcANV1l7EHukCeXqrzT1hNZjGlUk7wuMO5jw
+        Note right of Person: Chains to ECR Auth
+        LE->>Person: Issue ECR vLEI Credential
+        Note right of Person: Schema: EEEy9PkikFcANV1l7EHukCeXqrzT1hNZjGlUk7wuMO5jw
+    end
+```
+
+## Key Design Patterns
+
+### 1. Credential Chaining
+
+- Each credential (except QVI) references its chained credentials through edges
+- Ensures verifiable chain of authority from GLEIF down to individual roles
+
+### 2. Compact credentials
+
+- Attributes and Rules can be either:
+  - Full objects with all properties
+  - SAIDs for compactness
+
+### 3. Common Rules Structure
+
+- All credentials share similar disclaimer structure
+- ECR Authorization adds privacy disclaimer for IPEX/ACDC
+
+### 4. Authorization Pattern
+
+- Legal Entities authorize QVIs to issue role credentials
+- Separates OOR (official roles) from ECR (engagement context roles)
+
+### 5. Legal Entities as issues
+
+- Legal Entities can issue their own ECR credentials without a preceeding ECR Auth
diff --git a/docs/content/vlei-dependency-graph.md b/docs/content/vlei-dependency-graph.md
new file mode 100644
index 0000000..f37cec3
--- /dev/null
+++ b/docs/content/vlei-dependency-graph.md
@@ -0,0 +1,120 @@
+# vLEI Credential Dependencies and Relationships
+
+## Dependency Graph
+
+```mermaid
+graph TD
+    %% Define nodes with schema IDs
+    GLEIF["GLEIF<br/>Root Authority"]
+    QVI["QVI vLEI Credential<br/>Schema: EBfdlu8R27Fbx-ehrqwImnK-8Cm79sqbAQ4MmvEAYqao<br/>Issued by: GLEIF"]
+    LE["Legal Entity vLEI Credential<br/>Schema: ENPXp1vQzRF6JwIuS-mp2U8Uf1MoADoP_GqQ62VsDZWY<br/>Issued by: QVI"]
+    OORAuth["OOR Authorization Credential<br/>Schema: EKA57bKBKxr_kN7iN5i7lMUxpMG-s19dRcmov1iDxz-E<br/>Issued by: Legal Entity"]
+    ECRAuth["ECR Authorization Credential<br/>Schema: EH6ekLjSr8V32WyFbGe1zXjTzFs9PkTYmupJ9H65O14g<br/>Issued by: Legal Entity"]
+    OOR["OOR vLEI Credential<br/>Schema: EBNaNu-M9P5cgrnfl2Fvymy4E_jvxxyjb70PRtiANlJy<br/>Issued by: QVI"]
+    ECR["ECR vLEI Credential<br/>Schema: [ECR Schema]<br/>Issued by: QVI"]
+    Person["Person/Role Holder"]
+
+    %% Define dependencies
+    GLEIF -->|issues| QVI
+    QVI -->|issues| LE
+    LE -->|authorizes via| OORAuth
+    LE -->|authorizes via| ECRAuth
+    OORAuth -->|enables issuance of| OOR
+    ECRAuth -->|enables issuance of| ECR
+    QVI -->|issues with auth| OOR
+    QVI -->|issues with auth| ECR
+    OOR -->|held by| Person
+    ECR -->|held by| Person
+
+    %% Edge dependencies (credential chaining)
+    LE -.->|edges.qvi references| QVI
+    OORAuth -.->|edges.le references| LE
+    ECRAuth -.->|edges.le references| LE
+    OOR -.->|edges.auth references| OORAuth
+
+    %% Styling
+    style GLEIF fill:#e1f5fe
+    style QVI fill:#fff3e0
+    style LE fill:#e8f5e9
+    style OORAuth fill:#fce4ec
+    style ECRAuth fill:#fce4ec
+    style OOR fill:#f3e5f5
+    style ECR fill:#f3e5f5
+    style Person fill:#e0e0e0
+```
+
+## Credential Dependencies Table
+
+| Credential Type | Schema SAID | Issuer | Required Dependencies | Edge References |
+|----------------|-------------|---------|----------------------|-----------------|
+| **QVI vLEI** | `EBfdlu8R27Fbx-ehrqwImnK-8Cm79sqbAQ4MmvEAYqao` | GLEIF | None (Root) | None |
+| **Legal Entity vLEI** | `ENPXp1vQzRF6JwIuS-mp2U8Uf1MoADoP_GqQ62VsDZWY` | QVI | QVI Credential | edges.qvi → QVI Schema |
+| **OOR Authorization** | `EKA57bKBKxr_kN7iN5i7lMUxpMG-s19dRcmov1iDxz-E` | Legal Entity | LE Credential | edges.le → LE Schema |
+| **ECR Authorization** | `EH6ekLjSr8V32WyFbGe1zXjTzFs9PkTYmupJ9H65O14g` | Legal Entity | LE Credential | edges.le → LE Schema |
+| **OOR vLEI** | `EBNaNu-M9P5cgrnfl2Fvymy4E_jvxxyjb70PRtiANlJy` | QVI | OOR Authorization | edges.auth → OOR Auth Schema |
+| **ECR vLEI** | `EEy9PkikFcANV1l7EHukCeXqrzT1hNZjGlUk7wuMO5jw` | QVI | ECR Authorization | edges.auth → ECR Auth Schema |
+
+## Dependency Rules
+
+### 1. **Hierarchical Dependencies**
+
+- GLEIF is the root authority (no dependencies)
+- QVIs must have valid GLEIF-issued credentials
+- Legal Entities must have valid QVI-issued credentials
+- Role credentials require authorization from Legal Entities
+
+### 2. **Edge-Based Verification**
+
+Each credential (except QVI) contains an `edges` block that references "chained" (directed edge) credentials:
+
+```json
+"edges": {
+  "chainedCredentialType": {
+    "n": "chained credential SAID",
+    "s": "chained schema SAID (constant)"
+  }
+}
+```
+
+### 3. **Authorization Flow**
+
+```mermaid
+sequenceDiagram
+    participant LE as Legal Entity
+    participant QVI as QVI
+    participant P as Person
+    
+    Note over LE,QVI: Authorization Phase
+    LE->>QVI: Issue OOR/ECR Authorization
+    Note right of QVI: Contains: AID, LEI, personLegalName, role
+    
+    Note over QVI,P: Issuance Phase
+    QVI->>P: Issue OOR/ECR Credential
+    Note right of P: Must reference authorization in edges
+```
+
+### 4. **Validation Chain**
+
+To validate any credential, verifiers must:
+
+1. Check the credential signature and status
+2. Follow edge references up the chain
+3. Validate each chained credential
+4. Ensure unbroken chain to GLEIF root
+
+## Critical Dependencies
+
+### For QVI Operations
+
+- **Required**: Valid QVI vLEI Credential from GLEIF
+- **Enables**: Issuing LE credentials, OOR/ECR credentials (with auth)
+
+### For Legal Entity Operations  
+
+- **Required**: Valid LE vLEI Credential from QVI
+- **Enables**: Issuing OOR/ECR Authorization credentials
+
+### For Role Issuance
+
+- **Required**: Valid Authorization credential from LE + Valid QVI credential
+- **Enables**: Issuing role credentials to persons
diff --git a/docs/index.html b/docs/index.html
new file mode 100644
index 0000000..310275c
--- /dev/null
+++ b/docs/index.html
@@ -0,0 +1,37 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>vLEI Infrastructure Documentation</title>
+    <link rel="stylesheet" href="styles.css">
+    <script src="https://cdn.jsdelivr.net/npm/marked@12.0.0/marked.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/mermaid@10.9.0/dist/mermaid.min.js"></script>
+</head>
+<body>
+    <div class="container">
+        <nav class="navbar">
+            <ul>
+                <li><a href="#" onclick="loadPage('index')">Overview</a></li>
+                <li><a href="#" onclick="loadPage('vlei-credential-ecosystem')">vLEI Ecosystem</a></li>
+                <li><a href="#" onclick="loadPage('vlei-dependency-graph')">Dependency Graph</a></li>
+                <li><a href="#" onclick="loadPage('credentials')">Credentials</a></li>
+                <li><a href="#" onclick="loadPage('qvi-credential-schema')">QVI Credential</a></li>
+                <li><a href="#" onclick="loadPage('legal-entity-credential-schema')">Legal Entity</a></li>
+                <li><a href="#" onclick="loadPage('oor-auth-credential-schema')">OOR Auth</a></li>
+                <li><a href="#" onclick="loadPage('ecr-auth-credential-schema')">ECR Auth</a></li>                
+                <li><a href="#" onclick="loadPage('oor-credential-schema')">OOR Credential</a></li>
+                <li><a href="#" onclick="loadPage('ecr-credential-schema')">ECR Credential</a></li>
+            </ul>
+        </nav>
+
+        <main class="content">
+            <div id="content-content">
+                <!-- Content will be loaded here -->
+            </div>
+        </main>
+    </div>
+
+    <script src="app.js"></script>
+</body>
+</html>
\ No newline at end of file
diff --git a/docs/styles.css b/docs/styles.css
new file mode 100644
index 0000000..be8b922
--- /dev/null
+++ b/docs/styles.css
@@ -0,0 +1,303 @@
+:root {
+  --gleif-green: #51dac5;
+  --gleif-green-light: #73e6d1;
+  --gleif-green-dark: #3db5a2;
+  --gleif-green-darker: #2a8b82;
+  --gleif-gray-dark: #2d3436;
+  --gleif-gray: #636e72;
+  --gleif-gray-medium: #b2bec3;
+  --gleif-gray-light: #ddd;
+  --gleif-gray-lighter: #f1f2f6;
+  --gleif-white: #ffffff;
+  --gleif-black: #2d3436;
+}
+
+* {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+}
+
+body {
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+  line-height: 1.6;
+  color: var(--gleif-gray-dark);
+  background-color: var(--gleif-gray-lighter);
+}
+
+/* Container */
+.container {
+  max-width: 1200px;
+  margin: 0 auto;
+  display: flex;
+  flex-direction: column;
+  padding: 2rem;
+  min-height: 100vh;
+}
+
+/* Top Navigation Bar */
+.navbar {
+  background-color: var(--gleif-white);
+  padding: 1.5rem 2rem;
+  border-radius: 8px;
+  margin-bottom: 2rem;
+  width: 100%;
+  border: 1px solid var(--gleif-gray-light);
+  box-shadow: 0 1px 3px rgba(0,0,0,0.1);
+}
+
+.navbar ul {
+  list-style: none;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.4rem;
+  justify-content: center;
+  margin-bottom: 0.25rem;
+}
+
+.navbar li {
+  margin-bottom: 0;
+}
+
+.navbar a {
+  color: var(--gleif-gray);
+  text-decoration: none;
+  padding: 0.3rem 0.6rem;
+  display: inline-block;
+  border-radius: 12px;
+  transition: all 0.3s ease;
+  font-size: 0.8rem;
+  white-space: nowrap;
+  border: 1px solid var(--gleif-gray-light);
+}
+
+.navbar a:hover {
+  background-color: var(--gleif-green);
+  color: var(--gleif-white);
+  border-color: var(--gleif-green);
+}
+
+.navbar a:active,
+.navbar a.active {
+  background-color: var(--gleif-green-dark);
+  color: var(--gleif-white);
+  border-color: var(--gleif-green-dark);
+}
+
+/* Main content */
+.content {
+  background-color: var(--gleif-white);
+  padding: 2rem;
+  border-radius: 8px;
+  box-shadow: 0 2px 10px rgba(0,0,0,0.05);
+  width: 100%;
+  flex: 1;
+}
+
+/* Typography */
+h1, h2, h3, h4, h5, h6 {
+  color: var(--gleif-gray-dark);
+  margin-bottom: 1rem;
+  margin-top: 2rem;
+}
+
+h1:first-child, h2:first-child, h3:first-child {
+  margin-top: 0;
+}
+
+h1 { font-size: 2.5rem; }
+h2 { font-size: 2rem; }
+h3 { font-size: 1.5rem; }
+h4 { font-size: 1.25rem; }
+
+p {
+  margin-bottom: 1rem;
+}
+
+/* Links */
+a {
+  color: var(--gleif-green-dark);
+  transition: color 0.3s ease;
+}
+
+a:hover {
+  color: var(--gleif-green);
+}
+
+/* Code blocks */
+pre {
+  background-color: var(--gleif-gray-lighter);
+  padding: 1rem;
+  border-radius: 4px;
+  border-left: 4px solid var(--gleif-green);
+  overflow-x: auto;
+  margin: 1rem 0;
+}
+
+code {
+  background-color: var(--gleif-gray-lighter);
+  padding: 0.2rem 0.4rem;
+  border-radius: 3px;
+  font-family: 'Monaco', 'Consolas', monospace;
+  font-size: 0.9em;
+  color: var(--gleif-gray-dark);
+}
+
+pre code {
+  background: none;
+  padding: 0;
+}
+
+/* Tables */
+table {
+  width: 100%;
+  border-collapse: collapse;
+  margin: 1rem 0;
+}
+
+th, td {
+  padding: 0.75rem;
+  text-align: left;
+  border-bottom: 1px solid var(--gleif-gray-light);
+}
+
+th {
+  background-color: var(--gleif-gray-lighter);
+  color: var(--gleif-gray-dark);
+  font-weight: 600;
+}
+
+/* Lists */
+ul, ol {
+  margin-left: 1.5rem;
+  margin-bottom: 1rem;
+}
+
+li {
+  margin-bottom: 0.25rem;
+}
+
+/* Blockquotes */
+blockquote {
+  border-left: 4px solid var(--gleif-green);
+  padding-left: 1rem;
+  margin: 1rem 0;
+  font-style: italic;
+  color: var(--gleif-gray);
+  background-color: var(--gleif-gray-lighter);
+  padding: 1rem;
+  border-radius: 4px;
+}
+
+/* Mermaid diagrams */
+.mermaid {
+  background-color: var(--gleif-white);
+  border: 1px solid var(--gleif-gray-light);
+  border-radius: 6px;
+  padding: 2rem;
+  margin: 2rem 0;
+  text-align: center;
+  width: 100%;
+  min-height: 500px;
+  overflow-x: auto;
+  cursor: zoom-in;
+  transition: all 0.3s ease;
+  position: relative;
+}
+
+/* Zoomed state */
+.mermaid.zoomed {
+  position: fixed;
+  top: 0;
+  left: 0;
+  width: 100vw;
+  height: 100vh;
+  z-index: 1000;
+  background-color: var(--gleif-white);
+  cursor: default;
+  overflow: auto;
+  margin: 0;
+  padding: 2rem;
+  transform: none;
+}
+
+.mermaid.zoomed svg {
+  cursor: grab;
+}
+
+.mermaid.zoomed svg:active {
+  cursor: grabbing;
+}
+
+
+/* Close button for zoomed diagrams */
+.mermaid.zoomed::after {
+  content: '×';
+  position: absolute;
+  top: 1rem;
+  right: 1rem;
+  width: 30px;
+  height: 30px;
+  background: var(--gleif-gray-dark);
+  color: white;
+  border-radius: 50%;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  cursor: pointer;
+  font-size: 20px;
+  font-weight: bold;
+  z-index: 1001;
+}
+
+
+.mermaid svg {
+  max-width: 100%;
+  width: auto;
+  height: auto;
+}
+
+
+/* Loading state */
+.loading {
+  text-align: center;
+  padding: 2rem;
+  color: var(--gleif-gray);
+}
+
+/* Responsive */
+@media (max-width: 768px) {
+  .container {
+    padding: 1rem;
+  }
+  
+  .navbar {
+    padding: 1rem;
+  }
+  
+  .navbar ul {
+    flex-direction: column;
+    align-items: center;
+  }
+  
+  .navbar a {
+    display: block;
+    text-align: center;
+    margin-bottom: 0.5rem;
+  }
+  
+  
+  .mermaid {
+    min-height: 300px;
+  }
+  
+  .mermaid svg {
+    min-width: 600px;
+    font-size: 14px !important;
+  }
+  
+  .mermaid .node text,
+  .mermaid .edgeLabel text {
+    font-size: 14px !important;
+  }
+}
\ No newline at end of file