{"id":51580047,"url":"https://github.com/blokzdev/fluensys-v2","last_synced_at":"2026-07-11T05:02:11.548Z","repository":{"id":364113627,"uuid":"1266391758","full_name":"blokzdev/fluensys-v2","owner":"blokzdev","description":null,"archived":false,"fork":false,"pushed_at":"2026-06-11T18:11:23.000Z","size":9736,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-11T18:22:12.833Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://fluensys-v2.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/blokzdev.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":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-11T15:17:24.000Z","updated_at":"2026-06-11T18:21:08.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/blokzdev/fluensys-v2","commit_stats":null,"previous_names":["blokzdev/fluensys-v2"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/blokzdev/fluensys-v2","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blokzdev%2Ffluensys-v2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blokzdev%2Ffluensys-v2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blokzdev%2Ffluensys-v2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blokzdev%2Ffluensys-v2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blokzdev","download_url":"https://codeload.github.com/blokzdev/fluensys-v2/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blokzdev%2Ffluensys-v2/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35351426,"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-11T02:00:05.354Z","response_time":104,"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":[],"created_at":"2026-07-11T05:02:10.705Z","updated_at":"2026-07-11T05:02:11.542Z","avatar_url":"https://github.com/blokzdev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FluenSys — Pumping Systems Consultancy Platform\n\nThe marketing site, knowledge hub and lead-generation engine for\n[Fluensys Limited](https://www.fluensys.co.uk) — an independent UK\nengineering consultancy with 50+ years of pump \u0026 fluids expertise.\n\nImmersive Next.js 16 experience (GSAP + Lenis + three.js/R3F), a git-native\nMDX **content lake** built to scale to thousands of enriched articles\n(figures, interactive charts, downloadable PDFs), AI **authoring routines**\ndriven by GitHub Issues/cron, and Firebase-powered engagement (guest \u0026\nGoogle sign-in, bookmarks, comments, newsletter).\n\n## Quick start\n\n```bash\nnpm install\ncp .env.example .env.local   # optional — site runs fully without env vars\nnpm run dev                  # http://localhost:3000\n```\n\n| Command | What it does |\n| --- | --- |\n| `npm run dev` | sync article assets + dev server |\n| `npm run build` | validate content → publish assets → search index → static build |\n| `npm run typecheck` | TypeScript |\n| `npm run content:validate` | schema-check the content lake (CI gate) |\n| `npm run pdf -- \u003ccategory\u003e \u003cslug\u003e` | generate an article PDF (running site + Playwright required) |\n\n## How it fits together\n\n```\ncontent/   ← articles (MDX+assets+PDF per folder), authors, taxonomy, site copy\nsrc/       ← Next.js app: static-first pages, GSAP/three motion, Firebase islands\nscripts/   ← content pipeline (validate/sync/index) + PDF generation\n.github/   ← CI + commission dispatch + versioned routine prompts\ndocs/      ← the operating manual — start at docs/00-vision.md\n```\n\nRead **[CLAUDE.md](CLAUDE.md)** (engineering ground rules) and the\n**[docs/](docs)** suite before contributing:\n\n- [00 Vision](docs/00-vision.md) · [01 Architecture](docs/01-architecture.md)\n- [02 Content pipeline](docs/02-content-pipeline.md) · [03 Authoring routines](docs/03-routines.md)\n- [04 Design system](docs/04-design-system.md) · [05 Firebase](docs/05-firebase.md)\n- [06 SEO](docs/06-seo.md) · [07 Deployment](docs/07-deployment.md) · [08 Roadmap](docs/08-roadmap.md)\n\n## Commissioning an article\n\nOpen a **\"📝 Commission an Article\"** issue (template provided). For\nauthorized authors (`.github/routines/authors.json`), the dispatch\nworkflow fires a [Claude Code Routine](https://code.claude.com/docs/en/routines)\nthat authors the piece: attach a pre-authored PDF to have the web article\nformulated from it, or provide a brief and the routine researches, writes,\nillustrates and generates the PDF — always delivered as a PR for human\nreview. A second, scheduled routine works through\n[docs/editorial-backlog.md](docs/editorial-backlog.md) weekly. Setup:\n[docs/03-routines.md](docs/03-routines.md).\n\n## License\n\n**Split licensing** (see [NOTICE](NOTICE)):\n\n- **Code** — [Apache License 2.0](LICENSE).\n- **Content \u0026 brand** (`content/`, imagery, PDFs, the FluenSys name) —\n  © Fluensys Limited, all rights reserved ([content/LICENSE.md](content/LICENSE.md)).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblokzdev%2Ffluensys-v2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblokzdev%2Ffluensys-v2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblokzdev%2Ffluensys-v2/lists"}