{"id":50097120,"url":"https://github.com/aixgo-dev/web","last_synced_at":"2026-05-23T04:11:30.745Z","repository":{"id":356284507,"uuid":"1228011290","full_name":"aixgo-dev/web","owner":"aixgo-dev","description":"Source for aixgo.dev — the marketing and documentation site for the Aixgo AI agent framework. Hugo + Cloudflare Pages.","archived":false,"fork":false,"pushed_at":"2026-05-15T16:32:06.000Z","size":525,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-15T19:25:05.017Z","etag":null,"topics":["ai-agents","ai-framework","ai-projects","ai-prompts","cloudflare-pages","documentation","golang","hugo","static-site"],"latest_commit_sha":null,"homepage":"https://aixgo.dev","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aixgo-dev.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":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-03T13:27:09.000Z","updated_at":"2026-05-15T16:30:19.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/aixgo-dev/web","commit_stats":null,"previous_names":["aixgo-dev/web"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/aixgo-dev/web","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aixgo-dev%2Fweb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aixgo-dev%2Fweb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aixgo-dev%2Fweb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aixgo-dev%2Fweb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aixgo-dev","download_url":"https://codeload.github.com/aixgo-dev/web/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aixgo-dev%2Fweb/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33382128,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T01:21:08.577Z","status":"online","status_checked_at":"2026-05-23T02:00:05.530Z","response_time":53,"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":["ai-agents","ai-framework","ai-projects","ai-prompts","cloudflare-pages","documentation","golang","hugo","static-site"],"created_at":"2026-05-23T04:11:29.983Z","updated_at":"2026-05-23T04:11:30.733Z","avatar_url":"https://github.com/aixgo-dev.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# aixgo-dev/web\n\nSource for [aixgo.dev](https://aixgo.dev) — the marketing and documentation site for the [Aixgo](https://github.com/aixgo-dev/aixgo) AI agent framework.\n\n\u003e **Looking to *use* Aixgo?** Visit [aixgo.dev](https://aixgo.dev) or the framework repo at [github.com/aixgo-dev/aixgo](https://github.com/aixgo-dev/aixgo). This repo is for contributors to the website itself.\n\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](LICENSE)\n[![Hugo](https://img.shields.io/badge/built%20with-Hugo-FF4088?style=flat-square\u0026logo=hugo)](https://gohugo.io)\n[![Cloudflare Pages](https://img.shields.io/badge/deployed%20on-Cloudflare%20Pages-F38020?style=flat-square\u0026logo=cloudflare)](https://aixgo.dev)\n[![Markdownlint](https://img.shields.io/badge/markdownlint-passing-brightgreen?style=flat-square)](https://github.com/DavidAnson/markdownlint)\n\n---\n\n## Quick start\n\n```bash\n# One-time\nbrew install hugo                  # or: see gohugo.io/installation\nmake lint-install                  # markdownlint-cli2 + htmlhint\n\n# Daily\nmake dev                           # http://localhost:1313 with live reload\nmake build                         # production build → public/\nmake lint                          # markdown + html lint\n```\n\nThe production Hugo version is set via `HUGO_VERSION` in the Cloudflare Pages project env vars (the canonical pin — not committed to this repo). Copy the value from the Cloudflare Pages dashboard to match locally.\n\n## Repository layout\n\n```text\nconfig/_default/        # Hugo configuration (hugo.toml, params.toml, menus, ...)\ncontent/                # Markdown content\n  ├── guides/           # Technical guides\n  ├── blog/             # Blog and release announcements\n  └── examples/         # YAML configuration examples\nlayouts/                # Hugo templates\n  ├── _default/         # baseof.html, list.html, single.html\n  ├── partials/         # Reusable components (head, header, footer, seo, posthog)\n  └── shortcodes/       # Markdown components (feature-card, status-badge, ...)\ndata/                   # YAML data files driving content\n  ├── features.yaml     # Feature matrix (status indicators)\n  ├── milestones.yaml   # Roadmap milestones\n  └── version.yaml      # Site version metadata\nstatic/                 # Assets (css, js, favicon, _headers, CNAME)\narchetypes/             # Hugo archetypes (templates for `hugo new`)\n.markdownlint.json      # Markdownlint config\n.htmlhintrc             # HTMLhint config\n```\n\n## How content is structured\n\nThe site is a mix of Markdown content and YAML data files. **Most updates are to the YAML data files, not the templates.** Examples:\n\n- Adding a feature to the matrix → edit `data/features.yaml`, no code or template change.\n- Updating a roadmap milestone → edit `data/milestones.yaml`.\n- Tweaking the homepage tagline → edit `data/version.yaml`.\n\nAnything that's prose for users (guides, blog posts) lives in `content/` as Markdown.\n\n## Common tasks\n\n### Add a new guide\n\n1. Create `content/guides/my-guide.md`.\n2. Add front matter:\n\n   ```yaml\n   ---\n   title: \"My Guide\"\n   description: \"What this guide teaches in one line.\"\n   weight: 50\n   ---\n   ```\n\n3. Write the content in Markdown. Use language tags on every code fence.\n4. Run `make lint` to confirm markdownlint passes.\n5. Run `make dev` and check the rendered page locally.\n\n### Add a blog post\n\n1. Create `content/blog/2026-mm-dd-slug.md`.\n2. Add front matter with `title`, `description`, `date`, and `tags`.\n3. Write the content. Open a PR.\n\n### Update the feature matrix\n\nEdit `data/features.yaml`. The `status` field uses `complete` / `in_progress` / `roadmap` and renders as a status badge. **Do not hardcode features into templates** — the YAML is the source of truth.\n\n### Update a milestone\n\nEdit `data/milestones.yaml`. Same pattern — the homepage milestone cards read from this file.\n\n### Add a Hugo shortcode\n\n1. Create `layouts/shortcodes/my-shortcode.html`.\n2. Use it in Markdown via `{{\u003c/* my-shortcode arg=\"value\" */\u003e}}`.\n3. Document it in this README's `## Shortcodes` section if it becomes load-bearing.\n\n## Deployment\n\nThe site is deployed to **Cloudflare Pages** with PostHog analytics. Cloudflare's GitHub app watches this repository and rebuilds on every push:\n\n1. Push to `main` → Cloudflare Pages builds with `hugo --minify --environment production` → deploys to [aixgo.dev](https://aixgo.dev).\n2. Open a PR → Cloudflare Pages builds a preview at `\u003cbranch\u003e.aixgo-web.pages.dev` (URL pattern depends on Cloudflare Pages project settings; the preview link is posted as a check on the PR).\n\n### Required environment variables\n\nThese are set in the Cloudflare Pages project settings (not in this repo). For local builds, copy `.env.example` to `.env` and populate.\n\n| Variable | Purpose |\n|---|---|\n| `HUGO_VERSION` | Hugo version pin (must match local) |\n| `HUGO_POSTHOG_KEY` | PostHog Project API Key (`phc_...`); analytics gated on this being set |\n| `HUGO_POSTHOG_HOST` | Optional, defaults to `https://us.i.posthog.com` |\n\n### Manual local production build\n\n```bash\nHUGO_POSTHOG_KEY=phc_xxx HUGO_POSTHOG_HOST=https://us.i.posthog.com make build\n# Output in public/\n```\n\n## Style conventions\n\n- **File naming**: `kebab-case.md` (e.g. `provider-integration.md`).\n- **Lists**: use `1.` for every numbered list item (markdownlint enforces).\n- **Code fences**: always specify language for syntax highlighting (`bash`, `go`, `yaml`, `text`).\n- **Internal links**: use Hugo's `ref` shortcode (`{{\u003c/* ref \"/guides/quick-start\" */\u003e}}`) so they survive renames.\n- **Data files first**: prefer YAML data updates over hardcoded content in templates.\n\n## Contributing\n\nOpen a PR. Cloudflare will build a preview within ~2 minutes; the link is posted as a check. Good first contributions: typo fixes, missing examples, broken links, new guides for under-documented framework features.\n\nFor framework documentation (API reference, ADRs), contribute to the [aixgo](https://github.com/aixgo-dev/aixgo) repo instead — the website embeds those rather than duplicating them.\n\n## See also\n\n- [aixgo](https://github.com/aixgo-dev/aixgo) — The Go framework this site documents.\n- [aixgate](https://github.com/aixgo-dev/aixgate) — The runtime sandbox companion.\n\n## License\n\n[MIT](LICENSE).\n\n\u003e aixgo.dev builds agents. Aixgate keeps them in their lane.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faixgo-dev%2Fweb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faixgo-dev%2Fweb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faixgo-dev%2Fweb/lists"}