{"id":51496855,"url":"https://github.com/vito416/blackcat-templates","last_synced_at":"2026-07-07T16:01:33.442Z","repository":{"id":352244615,"uuid":"1183579177","full_name":"Vito416/blackcat-templates","owner":"Vito416","description":"Template registry/rendering toolkit for Blackcat frontends (deploy to Arweave).","archived":false,"fork":false,"pushed_at":"2026-04-18T15:29:25.000Z","size":101,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-18T17:21:38.447Z","etag":null,"topics":["ao","arweave","bfnl","blackcat","blackcat-covered-system","custom-license","darkmesh","source-available","weavedb","web3"],"latest_commit_sha":null,"homepage":"https://github.com/Vito416","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Vito416.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-16T18:46:33.000Z","updated_at":"2026-04-18T15:29:30.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Vito416/blackcat-templates","commit_stats":null,"previous_names":["vito416/blackcat-templates"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Vito416/blackcat-templates","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vito416%2Fblackcat-templates","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vito416%2Fblackcat-templates/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vito416%2Fblackcat-templates/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vito416%2Fblackcat-templates/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Vito416","download_url":"https://codeload.github.com/Vito416/blackcat-templates/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vito416%2Fblackcat-templates/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35234127,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-07T02:00:07.222Z","response_time":90,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ao","arweave","bfnl","blackcat","blackcat-covered-system","custom-license","darkmesh","source-available","weavedb","web3"],"created_at":"2026-07-07T16:01:32.334Z","updated_at":"2026-07-07T16:01:33.425Z","avatar_url":"https://github.com/Vito416.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BlackCat Darkmesh Templates\n\nTemplate registry and CLI for public, verifiable assets used by the Blackcat Darkmesh ecosystem.\nThis repo now includes:\n- docs/scaffolding templates (`module_readme`, `module_roadmap`)\n- gateway search UX templates with three distinct monolithic variants:\n  - `gateway_search_variant_signal`\n  - `gateway_search_variant_bastion`\n  - `gateway_search_variant_horizon`\n- gateway search **component kit** (front-end building blocks):\n  - `gateway_search_shell_core` (page skeleton)\n  - menu/search/results/footer fragments in three original styles (`pulse`, `atlas`, `lumen`)\n  - `gateway:compose` command that assembles shell + selected style profile\n- gateway search index placeholders for the public-read path:\n  - `INDEX_FETCH_MODE`\n  - `PUBLIC_INDEX_ENDPOINT`\n  - `INDEX_REQUEST_BODY_JSON`\n- pinned release workflow:\n  - `gateway:release:build` for immutable release maps\n- block-library batch 02 (stavebnice for real site flows):\n  - auth blocks (`login`, `register`, `recovery`)\n  - commerce blocks (`product-grid`, `cart-drawer`, `checkout-summary`)\n  - content blocks (`hero`, `feature-grid`, `faq`, `cta-band`)\n  - account blocks (`dashboard`, `orders`, `security`, `notifications`)\n- block-spec scaffolding for TS/JS frontend logic:\n  - `contracts/schemas/*.v0.1.schema.json`\n  - `contracts/examples/*.json`\n\n## What this repo is for\n- Keep template bundles outside gateway runtime code.\n- Render deterministic, auditable artifacts before publish (for Arweave release flow).\n- Keep OTP-first trust and route resolution on the gateway worker; use the public-read index path only for the read-only catalog.\n- Enforce a basic security policy and integration declarations per template.\n\n## Quick Start\n```bash\nnpm ci\nexport BLACKCAT_TEMPLATES_CONFIG=$(pwd)/blackcat-darkmesh-templates/config/example.templates.json\n\n# Catalog / metadata\nblackcat-darkmesh-templates/bin/templates $BLACKCAT_TEMPLATES_CONFIG catalog:list\nblackcat-darkmesh-templates/bin/templates $BLACKCAT_TEMPLATES_CONFIG catalog:show gateway_search_variant_signal\n\n# Render docs template\nblackcat-darkmesh-templates/bin/templates $BLACKCAT_TEMPLATES_CONFIG template:run module_readme '{\"MODULE_NAME\":\"BlackCat Payments\",\"DESCRIPTION\":\"Gateway + AO write boundary\"}'\n\n# Render one gateway-search variant\nblackcat-darkmesh-templates/bin/templates $BLACKCAT_TEMPLATES_CONFIG template:run gateway_search_variant_bastion '{\"SITE_TITLE\":\"Darkmesh Search\",\"GATEWAY_ORIGIN\":\"https://gateway.example\",\"SEARCH_ACTION\":\"public.resolve-route\"}' var/gateway-search-bastion.html\n\n# Compose a chunked front-end page (shell + fragments)\nblackcat-darkmesh-templates/bin/templates $BLACKCAT_TEMPLATES_CONFIG gateway:compose pulse '{\"SITE_TITLE\":\"Darkmesh Search\",\"SITE_TAGLINE\":\"Composable public UX\",\"GATEWAY_ORIGIN\":\"https://gateway.example\",\"SEARCH_ACTION\":\"public.resolve-route\"}' var/gateway-search-pulse.html\n\n# Security checks\nblackcat-darkmesh-templates/bin/templates $BLACKCAT_TEMPLATES_CONFIG security:scan\n```\n\nBackwards-compatible shorthand:\n```bash\nblackcat-darkmesh-templates/bin/template readme \"BlackCat Foo\" \"Short description\"\n```\n\n## Telemetry\n- Prometheus output file: `var/metrics.prom`\n- Counters: `template_catalog_total`, `template_render_total`, `template_security_issues`\n\n## Testing\n```bash\nnpm test\n```\nSmoke test boots registry, renders templates, runs security scan, and verifies metrics output.\n\n## Gateway search release docs\n- Runbook: `docs/GATEWAY_SEARCH_RELEASE.md`\n- Component kit guide: `docs/GATEWAY_COMPONENT_KIT.md`\n- Block spec v0.1: `docs/BLOCK_SPEC_V0_1.md`\n- Block library batch 02: `docs/BLOCK_LIBRARY_BATCH_02.md`\n- Variant map example: `docs/gateway-search-variant-map.example.json`\n- Release map v0.1.0: `docs/releases/gateway-search-v0.1.0.json`\n- Release build command: `gateway:release:build`\n\n## Component-kit model (project default)\n- Templates are split into reusable parts (`menu`, `search`, `results`, `footer`) rather than one big page.\n- The shell stays stable; styles swap per component profile.\n- Gateway keeps templates public/deterministic and can cache them safely.\n- This lets each site compose unique UX while preserving the same verified runtime flow.\n- Frontend logic stays in TS/JS bundles per block (state-machine oriented), while signing/secrets stay worker-side.\n\n## Licensing\n\nThis repository is an official component of the Blackcat Covered System. It is licensed under `BFNL-1.0`, and repository separation inside `BLACKCAT_MESH_NEXUS` exists for maintenance, safety, auditability, delivery, and architectural clarity. It does not by itself create a separate unavoidable founder-fee or steward/development-fee event for the same ordinary covered deployment.\n\nCanonical licensing bundle:\n- BFNL 1.0: https://github.com/Vito416/blackcat-darkmesh-ao/blob/main/docs/BFNL-1.0.md\n- Founder Fee Policy: https://github.com/Vito416/blackcat-darkmesh-ao/blob/main/docs/FEE_POLICY.md\n- Covered-System Notice: https://github.com/Vito416/blackcat-darkmesh-ao/blob/main/docs/LICENSING_SYSTEM_NOTICE.md\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvito416%2Fblackcat-templates","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvito416%2Fblackcat-templates","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvito416%2Fblackcat-templates/lists"}