Visual Diagrams

Interactive diagrams explaining Skippy's core concepts and workflows.

How to Use

These diagrams are created with Excalidraw. You can:

• View: Open .excalidraw files in VS Code (with Excalidraw extension) or at excalidraw.com
• Edit: Modify diagrams and export as SVG/PNG
• Embed: Use exported images in documentation

Available Diagrams

End-to-End Complete Flow

New! Comprehensive visualization of the entire credential lifecycle from setup to verification.

Shows the complete journey:

• Organization & project setup (Issuer)
• Credential template creation
• Issuance to holder
• Holder claiming process
• Verification setup
• Credential presentation to verifier

---

Organization Setup

New! Step-by-step visualization of the initial account and organization setup process.

Shows:

1. User registration
2. Organization creation with DID
3. API key generation

---

Template Creation

New! Detailed workflow for creating credential templates and projects.

Illustrates:

• Project configuration
• Template basic information
• Attribute definition
• Display settings
• Final template ready state

---

Claiming Flow

New! Holder-centric view of the credential claiming process.

Details:

1. Email notification receipt
2. Claim link activation
3. Wallet opening and preview
4. Credential review
5. Storage confirmation
6. Issuer status update

---

System Architecture

Shows how your app integrates with Skippy API and holder wallets.

Your App → Skippy API → Holder Wallet
    ↑          ↓
    └── Webhooks ←┘

📁 system-architecture.excalidraw

---

Credential Issuance Flow

The 5-step process from creating an offer to credential storage.

1. Issuer creates offer via API/UI
2. Skippy emails holder
3. Holder opens claim link
4. Wallet requests credential
5. Credential issued and stored

📁 credential-issuance-flow.excalidraw

---

Verification Flow

How verifiers request and receive credential presentations.

1. Verifier creates request
2. Shares QR/link with holder
3. Holder scans/opens
4. Selects credential, consents
5. Verification result returned

📁 verification-flow.excalidraw

---

DID Hierarchy

Organization → Project → Issuer/Verifier DID relationships.

Organization (did:web:company.com)
    └── Project: HR (did:key:z6Mk...)
        ├── Issuer DID (signs credentials)
        └── Verifier DID (requests proofs)

📁 did-hierarchy.excalidraw

Editing Diagrams

In VS Code

1. Install "Excalidraw" extension
2. Open .excalidraw file
3. Edit visually
4. Save (auto-saves JSON)

In Browser

1. Go to excalidraw.com
2. File → Open → select .excalidraw file
3. Edit
4. File → Save to disk

Exporting for Docs

1. Select all elements (Ctrl/Cmd + A)
2. Export → SVG (recommended) or PNG
3. Save to static/img/diagrams/
4. Reference in markdown:

   ![Issuance Flow](/img/diagrams/credential-issuance-flow.svg)

Style Guide

Element	Color	Use For
Purple #6366f1	Issuer/Your App
Violet #8b5cf6	Skippy
Green #10b981	Holder/Wallet
Amber #f59e0b	Verifier/Webhooks
Gray #64748b	Storage/Infrastructure

Font: 16px minimum for readability Backgrounds: Use light tints of the stroke color