# Video Tutorials

Step-by-step video guides for contributing to the Orama Network codebase. New tutorials are added regularly.

---

## Getting Started

<div className="grid grid-cols-1 sm:grid-cols-2 gap-4 mt-4">

<div className="border border-border/40 rounded-lg overflow-hidden bg-surface-2/30">
  <div className="aspect-video bg-surface-2/60 flex items-center justify-center text-muted">
    <span className="text-sm font-mono">Coming Soon</span>
  </div>
  <div className="p-4">
    <h4 className="text-sm font-medium text-fg">Dev Environment Setup</h4>
    <p className="text-xs text-muted mt-1">Clone the repo, install Go and dependencies, build all binaries, and run your first test.</p>
  </div>
</div>

<div className="border border-border/40 rounded-lg overflow-hidden bg-surface-2/30">
  <div className="aspect-video bg-surface-2/60 flex items-center justify-center text-muted">
    <span className="text-sm font-mono">Coming Soon</span>
  </div>
  <div className="p-4">
    <h4 className="text-sm font-medium text-fg">Project Architecture Walkthrough</h4>
    <p className="text-xs text-muted mt-1">Understand the monorepo layout: cmd/, pkg/, sdk/, e2e/, and how all components connect.</p>
  </div>
</div>

</div>

---

## Development Workflow

<div className="grid grid-cols-1 sm:grid-cols-2 gap-4 mt-4">

<div className="border border-border/40 rounded-lg overflow-hidden bg-surface-2/30">
  <div className="aspect-video bg-surface-2/60 flex items-center justify-center text-muted">
    <span className="text-sm font-mono">Coming Soon</span>
  </div>
  <div className="p-4">
    <h4 className="text-sm font-medium text-fg">Writing and Running Tests</h4>
    <p className="text-xs text-muted mt-1">Unit tests with make test, E2E tests with sandbox clusters, and the full test matrix.</p>
  </div>
</div>

<div className="border border-border/40 rounded-lg overflow-hidden bg-surface-2/30">
  <div className="aspect-video bg-surface-2/60 flex items-center justify-center text-muted">
    <span className="text-sm font-mono">Coming Soon</span>
  </div>
  <div className="p-4">
    <h4 className="text-sm font-medium text-fg">Sandbox Clusters</h4>
    <p className="text-xs text-muted mt-1">Create ephemeral 5-node Hetzner clusters for testing. Setup, deploy, SSH, and teardown.</p>
  </div>
</div>

<div className="border border-border/40 rounded-lg overflow-hidden bg-surface-2/30">
  <div className="aspect-video bg-surface-2/60 flex items-center justify-center text-muted">
    <span className="text-sm font-mono">Coming Soon</span>
  </div>
  <div className="p-4">
    <h4 className="text-sm font-medium text-fg">Rolling Deployments</h4>
    <p className="text-xs text-muted mt-1">Build, push, and upgrade nodes. Raft-safe rolling restart with health verification.</p>
  </div>
</div>

<div className="border border-border/40 rounded-lg overflow-hidden bg-surface-2/30">
  <div className="aspect-video bg-surface-2/60 flex items-center justify-center text-muted">
    <span className="text-sm font-mono">Coming Soon</span>
  </div>
  <div className="p-4">
    <h4 className="text-sm font-medium text-fg">Debugging with orama inspect</h4>
    <p className="text-xs text-muted mt-1">SSH-based cluster health inspection, monitor TUI, and diagnosing node issues.</p>
  </div>
</div>

</div>

---

## Deep Dives

<div className="grid grid-cols-1 sm:grid-cols-2 gap-4 mt-4">

<div className="border border-border/40 rounded-lg overflow-hidden bg-surface-2/30">
  <div className="aspect-video bg-surface-2/60 flex items-center justify-center text-muted">
    <span className="text-sm font-mono">Coming Soon</span>
  </div>
  <div className="p-4">
    <h4 className="text-sm font-medium text-fg">Gateway Internals</h4>
    <p className="text-xs text-muted mt-1">Request lifecycle: auth middleware, routing, rate limiting, and cross-node proxy.</p>
  </div>
</div>

<div className="border border-border/40 rounded-lg overflow-hidden bg-surface-2/30">
  <div className="aspect-video bg-surface-2/60 flex items-center justify-center text-muted">
    <span className="text-sm font-mono">Coming Soon</span>
  </div>
  <div className="p-4">
    <h4 className="text-sm font-medium text-fg">Adding a New Service</h4>
    <p className="text-xs text-muted mt-1">End-to-end guide: handler, routes, middleware, SDK client, and E2E tests.</p>
  </div>
</div>

<div className="border border-border/40 rounded-lg overflow-hidden bg-surface-2/30">
  <div className="aspect-video bg-surface-2/60 flex items-center justify-center text-muted">
    <span className="text-sm font-mono">Coming Soon</span>
  </div>
  <div className="p-4">
    <h4 className="text-sm font-medium text-fg">WASM Function Runtime</h4>
    <p className="text-xs text-muted mt-1">How wazero executes functions: host bindings, sandbox isolation, and the build pipeline.</p>
  </div>
</div>

<div className="border border-border/40 rounded-lg overflow-hidden bg-surface-2/30">
  <div className="aspect-video bg-surface-2/60 flex items-center justify-center text-muted">
    <span className="text-sm font-mono">Coming Soon</span>
  </div>
  <div className="p-4">
    <h4 className="text-sm font-medium text-fg">TypeScript SDK Development</h4>
    <p className="text-xs text-muted mt-1">Contributing to the SDK: project structure, adding a client module, and publishing.</p>
  </div>
</div>

</div>
