localLOOP

The official website of localLOOP and home of the LOOP protocol, MaterialDNA, ProductDNA, city portals, and governance.

Early-stage, low-TRL concept. No public pilots or deployments. Lab demo only.

---

What this is

This repository is the source for localloop.urbnia.com — the official website of the localLOOP project and the canonical home for everything LOOP.

It does three things:

1. Is the home of LOOP — spec, changelog, schemas, JSON-LD contexts, and examples for the LOOP protocol, MaterialDNA, ProductDNA, and governance RFCs
2. Documents lab concepts — MaterialDNA, ProductDNA, city-portal concepts, implementation notes, regulatory research, and governance drafts
3. Collects consent-based interest — a public expression-of-interest form backed by the localloop-backend API; do not submit sensitive information

---

Site map

Section	URL	Description
Home	/	Project overview
Protocol	/protocol	Spec, changelog, security policy
Platform	/platform	Platform hub
└ MaterialDNA	/platform/materialdna	Material identity layer
└ ProductDNA	/platform/productdna	Draft product-identity and passport-style fields for research (not ESPR-aligned)
└ City Portals	/platform/city-portals	City landing pages
└ DEMO City	/platform/demo-city	Sample city portal
Library	/library	Schemas and payload examples
Docs	/docs	9 implementation + reference guides
Governance	/governance	RFC guide, template, smart contract RFC
Engage	/interest	Expression of interest form

---

Stack

Layer	Choice
Framework	Next.js 16 (App Router, static export)
Runtime	Bun
Styling	Vanilla CSS (custom design system)
Testing	Playwright (E2E) + Node smoke tests
Deploy	Docker + Traefik on VPS
Protocol artifacts	Mirrored from loop-protocol into public/projects/loop-protocol/

---

Getting started

# Install dependencies
bun install

# Start dev server (http://localhost:3000)
bun run dev

# Static export → out/
bun run build

# Domain policy checks
bun run check:domains

---

Testing

# Smoke tests
bun run test

# Playwright E2E (builds first, then runs against the export)
bun run test:e2e

# Single spec
bunx playwright test tests/e2e/accessibility.spec.ts

---

Repo layout

app/
  (platform)/         # Platform section — MaterialDNA, ProductDNA, cities
  (engage)/           # Interest form, contribute, projects
  docs/               # Guides + reference pages
  governance/         # RFC guide, template, smart contracts
  library/            # Schemas + examples
  protocol/           # Spec, changelog, security
  config/
    siteRoutes.js     # Single source of truth for nav + sitemap
    sections.js       # Sidebar config for all sections
  components/         # SiteHeader, SiteFooter, Sidebar, Cards, …

public/
  projects/loop-protocol/   # Mirrored protocol artifacts (schemas, docs, contexts)
  viewer.html               # Lightweight markdown + JSON viewer
  assets/                   # CSS, JS, fonts

tests/
  e2e/                      # Playwright specs (one per key page)
  smoke/                    # Node smoke tests

---

Keeping protocol content in sync

Protocol artifacts (schemas, docs, JSON-LD contexts) live in loop-protocol and are mirrored here under public/projects/loop-protocol/. When the protocol repo is updated, copy the changed files into that directory and commit.

The Domain Consistency CI workflow validates that all internal links respect the canonical domain policy (localloop.urbnia.com / loop-api.urbnia.com).

---

Contributing

1. Fork and clone
2. bun install && bun run dev
3. Follow the route + sidebar pattern in app/config/
4. Add a Playwright spec in tests/e2e/ for any new interactive or critical page
5. Open a PR — CI runs build + E2E before merge

For org-level context, domain policy, and agents guidance see AGENTS.md in the monorepo root.

---

Related repos

Repo	Description
loop-protocol	Protocol source — schemas, spec, RFCs, JSON-LD contexts
localloop-backend	Lab backend API — interest registry, demo flows, SSE, federation

---

Built with Next.js · Deployed with Docker + Traefik · Part of the localLOOP project