https://github.com/local-loop-io/local-loop-io.github.io
localLOOP: Official website and home of Local Optimization with Overflow Protocol (LOOP), MaterialDNA, ProductDNA, city portals, and governance. Publishes the protocol spec, schemas, JSON-LD contexts, implementation guides, and a live expression-of-interest registry. Built with Next.js 16, statically exported to GitHub Pages.
https://github.com/local-loop-io/local-loop-io.github.io
bun circular-economy digital-product-passport documentation federation github-pages json-ld low-trl materialdna nextjs open-standard productdna protocol react sustainability
Last synced: 27 days ago
JSON representation
localLOOP: Official website and home of Local Optimization with Overflow Protocol (LOOP), MaterialDNA, ProductDNA, city portals, and governance. Publishes the protocol spec, schemas, JSON-LD contexts, implementation guides, and a live expression-of-interest registry. Built with Next.js 16, statically exported to GitHub Pages.
- Host: GitHub
- URL: https://github.com/local-loop-io/local-loop-io.github.io
- Owner: local-loop-io
- License: mit
- Created: 2025-12-19T10:16:09.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-05-26T10:24:24.000Z (27 days ago)
- Last Synced: 2026-05-26T11:14:50.566Z (27 days ago)
- Topics: bun, circular-economy, digital-product-passport, documentation, federation, github-pages, json-ld, low-trl, materialdna, nextjs, open-standard, productdna, protocol, react, sustainability
- Language: JavaScript
- Homepage: https://local-loop-io.github.io
- Size: 1.77 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# localLOOP
**The official website of localLOOP and home of the LOOP protocol, MaterialDNA, ProductDNA, city portals, and governance.**
[](https://github.com/local-loop-io/local-loop-io.github.io/actions/workflows/deploy.yml)
[](https://local-loop-io.github.io)
[](https://github.com/local-loop-io/loop-protocol)
[](LICENSE)
[](https://local-loop-io.github.io/protocol/spec)
> **Early-stage, low-TRL concept.** No public pilots or deployments. Lab demo only.
---
## What this is
This repository is the source for **[local-loop-io.github.io](https://local-loop-io.github.io)** — 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. **Runs the platform** — MaterialDNA, ProductDNA, city portals, implementation guides, regulatory alignment, and the full governance framework
3. **Collects interest** — a public expression-of-interest form backed by the [localloop-backend](https://github.com/local-loop-io/localloop-backend) API
---
## 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` | Product digital passport (ESPR Art. 9-10) |
| └ 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 | GitHub Pages via Actions |
| Protocol artifacts | Mirrored from `loop-protocol` into `public/projects/loop-protocol/` |
---
## Getting started
```bash
# Install dependencies
bun install
# Start dev server (http://localhost:3000)
bun run dev
# Type-check
bun run typecheck
# Static export → out/
bun run build
```
---
## Testing
```bash
# 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/platform.spec.ts
```
---
## Repo layout
```
app/
(platform)/ # Platform section — MaterialDNA, ProductDNA, cities
(engage)/ # Interest form, contribute, projects
docs/ # 9 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`](https://github.com/local-loop-io/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 (`local-loop-io.github.io` / `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 page
5. Open a PR — CI runs build + E2E before merge
For org-level context, domain policy, and agents guidance see [`AGENTS.md`](../AGENTS.md) in the monorepo root.
---
## Related repos
| Repo | Description |
|---|---|
| [`loop-protocol`](https://github.com/local-loop-io/loop-protocol) | Protocol source — schemas, spec, RFCs, JSON-LD contexts |
| [`localloop-backend`](https://github.com/local-loop-io/localloop-backend) | Lab backend API — interest registry, demo flows, SSE, federation |
---
Built with [Next.js](https://nextjs.org) · Deployed on [GitHub Pages](https://pages.github.com) · Part of the [localLOOP](https://local-loop-io.github.io) project