{"id":50527291,"url":"https://github.com/fleetbase/fleetbase.io","last_synced_at":"2026-06-03T09:02:14.034Z","repository":{"id":356507900,"uuid":"897697084","full_name":"fleetbase/fleetbase.io","owner":"fleetbase","description":"Fleetbase Official Website, and Documentation","archived":false,"fork":false,"pushed_at":"2026-05-27T07:43:26.000Z","size":314593,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-05-27T08:25:44.393Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://fleetbase.io","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fleetbase.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","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":"2024-12-03T04:35:29.000Z","updated_at":"2026-05-27T07:11:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/fleetbase/fleetbase.io","commit_stats":null,"previous_names":["fleetbase/fleetbase.io"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/fleetbase/fleetbase.io","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fleetbase%2Ffleetbase.io","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fleetbase%2Ffleetbase.io/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fleetbase%2Ffleetbase.io/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fleetbase%2Ffleetbase.io/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fleetbase","download_url":"https://codeload.github.com/fleetbase/fleetbase.io/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fleetbase%2Ffleetbase.io/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33856287,"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-06-03T02:00:06.370Z","response_time":59,"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-06-03T09:02:12.330Z","updated_at":"2026-06-03T09:02:14.022Z","avatar_url":"https://github.com/fleetbase.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# fleetbase.io\n\nThe marketing site, documentation, and developer portal for [Fleetbase](https://fleetbase.io) — the open-source logistics and supply-chain platform.\n\n![Fleetbase — Your Fleet. Your Data. Your Platform.](./public/images/og-image.webp)\n\n## What's in this repo\n\n- **Marketing site** — home, platform pages, solutions, pricing, partners, customer stories (`/oli-max`, `/true-vegan`)\n- **Documentation** — Platform, FleetOps, Storefront, Pallet, Ledger, CLI, Fleetbase UI, Extension Development, API Reference, Contributing — all rendered with [Fumadocs](https://fumadocs.dev)\n- **API reference generator** — auto-generates `/docs/api/*` MDX from the [`fleetbase/postman`](https://github.com/fleetbase/postman) collection at build time (see `scripts/generate-api-docs.mjs`)\n- **Blog** — pulled from a Ghost CMS via the Content API\n- **Customer stories** — branded landing pages for production deployments of the Fleetbase Storefront app\n\n## Tech stack\n\n- **Next.js 15** with the App Router\n- **TypeScript**, **React 19**\n- **Tailwind CSS 4** + **shadcn/ui** components\n- **Fumadocs** for the documentation system (MDX + search)\n- **Ghost** for blog content\n- **PostHog** for product analytics\n- **pnpm** for package management\n- **Vercel** for hosting\n\n## Local development\n\nRequirements: Node.js 20+, pnpm 10+.\n\n```bash\ngit clone --recurse-submodules git@github.com:fleetbase/fleetbase.io.git\ncd fleetbase.io\npnpm install\npnpm dev\n```\n\nThe site runs at \u003chttp://localhost:3000\u003e.\n\n\u003e The `vendor/postman` git submodule supplies the API documentation source. If you cloned without `--recurse-submodules`, run `git submodule update --init --recursive` before `pnpm install`.\n\n### Environment variables\n\nCopy `.env.local.example` to `.env.local` and fill in the required values:\n\n| Variable                   | Purpose                                               |\n| :------------------------- | :---------------------------------------------------- |\n| `NEXT_PUBLIC_POSTHOG_KEY`  | PostHog project key (frontend)                        |\n| `NEXT_PUBLIC_POSTHOG_HOST` | PostHog ingest host (e.g. `https://us.i.posthog.com`) |\n| `GHOST_API_URL`            | Ghost CMS base URL for the blog                       |\n| `GHOST_CONTENT_API_KEY`    | Ghost Content API key                                 |\n| `GHOST_API_VERSION`        | Ghost API version (e.g. `v5.0`)                       |\n\nWithout the Ghost variables, blog routes fall back to an empty state. Without the PostHog variables, analytics calls no-op locally.\n\n## Scripts\n\n```bash\npnpm dev               # start the dev server (regenerates API docs first)\npnpm build             # production build (regenerates API docs first)\npnpm start             # serve the production build\npnpm generate:api-docs # regenerate /docs/api/* from the postman submodule\npnpm lint              # next lint\n```\n\n## Project layout\n\n```\nfleetbase.io/\n├── content/            # MDX content for docs, blog, changelog\n│   ├── docs/           # docs sections — platform, fleet-ops, storefront, etc.\n│   ├── blog/           # blog post sources\n│   └── changelog/\n├── public/             # static assets\n│   └── images/\n│       └── screenshots/  # console + mobile app screenshots used across the site\n├── scripts/            # build-time helpers\n│   ├── generate-api-docs.mjs   # walks vendor/postman and emits /docs/api/* MDX\n│   ├── sdk-emitters.mjs        # JS / PHP / Python SDK code samples\n│   └── api-docs.config.mjs     # per-collection mapping \u0026 SDK store names\n├── src/\n│   ├── app/            # Next.js App Router routes\n│   ├── components/     # UI components, layout, MDX components\n│   └── lib/            # utilities, source loaders, GitHub stars helper\n├── vendor/\n│   └── postman/        # submodule — fleetbase/postman collection\n├── source.config.ts    # Fumadocs MDX source registration\n└── next.config.ts\n```\n\n## Documentation\n\nDocs live in `content/docs/` as `.mdx` files. Each top-level folder (`platform/`, `fleet-ops/`, `storefront/`, etc.) is registered as its own Fumadocs source in [`src/lib/source.ts`](./src/lib/source.ts) and gets its own sidebar.\n\nThe API reference under `/docs/api/*` is **auto-generated** from the [postman submodule](./vendor/postman) — don't edit those MDX files directly. To improve the API reference, edit the YAML side-files in `vendor/postman` and submit a PR there. See [`scripts/README.md`](./scripts/README.md) for the full generator architecture.\n\n## Contributing\n\nThe [Contributing Guide](https://fleetbase.io/docs/contributing) covers code, documentation, translations, extensions, and reporting issues. PRs welcome.\n\n## License\n\n[AGPL-3.0](./LICENSE.md). Commercial licensing is available — see [/licensing/commercial](https://fleetbase.io/licensing/commercial) for full details, pricing tiers, and terms.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffleetbase%2Ffleetbase.io","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffleetbase%2Ffleetbase.io","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffleetbase%2Ffleetbase.io/lists"}