{"id":50465495,"url":"https://github.com/threefoldtech/grid_manual","last_synced_at":"2026-06-01T07:03:34.447Z","repository":{"id":89667580,"uuid":"598123952","full_name":"threefoldtech/grid_manual","owner":"threefoldtech","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-27T14:04:22.000Z","size":198469,"stargazers_count":2,"open_issues_count":14,"forks_count":2,"subscribers_count":12,"default_branch":"development","last_synced_at":"2026-05-27T15:24:51.378Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://threefoldtech.github.io/grid_manual/","language":"JavaScript","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/threefoldtech.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":"CODEOWNERS","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":"2023-02-06T13:01:35.000Z","updated_at":"2026-05-27T14:06:23.000Z","dependencies_parsed_at":"2025-07-22T19:26:03.316Z","dependency_job_id":null,"html_url":"https://github.com/threefoldtech/grid_manual","commit_stats":null,"previous_names":["threefoldtech/grid_manual"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/threefoldtech/grid_manual","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/threefoldtech%2Fgrid_manual","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/threefoldtech%2Fgrid_manual/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/threefoldtech%2Fgrid_manual/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/threefoldtech%2Fgrid_manual/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/threefoldtech","download_url":"https://codeload.github.com/threefoldtech/grid_manual/tar.gz/refs/heads/development","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/threefoldtech%2Fgrid_manual/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33763668,"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-01T02:00:06.963Z","response_time":115,"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-01T07:03:33.632Z","updated_at":"2026-06-01T07:03:34.442Z","avatar_url":"https://github.com/threefoldtech.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Grid Manual\n\nA Docusaurus-based documentation site containing user guides, technical references, and FAQ content for grid infrastructure.\n\n## What this is\n\nGrid Manual is the primary documentation platform for the decentralized infrastructure stack. It provides comprehensive instructions for operators, developers, and end users interacting with the grid, including farming guides, deployment tutorials, API references, and troubleshooting documentation.\n\nThe site is built as a static site using Docusaurus and is designed to be the single source of truth for all grid-related documentation.\n\n## What this repository contains\n\n- Docusaurus site configuration and theme customization\n- Markdown documentation source files organized by topic\n- Custom client-side search engine implementation\n- Dynamic content generation scripts (pricing data, search index)\n- Build and deployment automation via Makefile\n\n## Role in the stack\n\nGrid Manual sits alongside the operational stack as the user-facing documentation layer. It explains how to use the grid infrastructure, from initial node setup to advanced workload deployment. The documentation is versioned and covers multiple network environments.\n\n## Relation to ThreeFold\n\nThis technology is used within the ThreeFold ecosystem and was first deployed on the ThreeFold Grid. The component itself is designed as reusable infrastructure technology and should be understood by its technical function first, independent of any specific deployment.\n\n## Ownership\n\nThis repository is owned and maintained by TF-Tech NV, a Belgian company responsible for the development and maintenance of this technology.\n\n## Browse docs\n\n- Official manual (master branch): [manual.grid.tf](https://manual.grid.tf/)\n- Staging (development branch): [www.manual.dev.grid.tf](https://www.manual.dev.grid.tf)\n- Staging (development-split branch): [www3.manual.grid.tf](https://www3.manual.grid.tf)\n\n## Development\n\n### Prerequisites\n\n```bash\n# Install dependencies\nmake install\n# or\nyarn install\n```\n\n### Quick Start\n\n```bash\n# Development server with live data generation\nmake dev\n# or\nyarn start\n```\n\nThis starts a local development server with auto-generated content and opens a browser window. Most changes are reflected live without restarting the server.\n\n### Build Process\n\n```bash\n# Generate all dynamic content\nmake prebuild\n\n# Full production build\nmake build\n\n# Serve built site locally\nmake serve\n```\n\n**Available Make targets:**\n- `make prepare-data` — generate pricing values from external APIs\n- `make generate-search` — create search index from documentation\n- `make prebuild` — run all pre-build data generation\n- `make build` — complete production build\n- `make dev` — development server with live updates\n- `make clean` — clean build artifacts\n\n## Architecture\n\n### Custom Search Engine\n\nA client-side search implementation provides fast, cost-free search without external dependencies. The search system indexes all documentation at build time and offers instant results with a mobile-optimized UI.\n\n### Dynamic Content Generation\n\n- **Pricing Values**: auto-updated from external market sources\n- **Search Index**: generated from all Markdown content with smart URL handling\n- **Responsive Design**: mobile-first UI with optimized navigation\n\n## Contribute\n\nBe sure to check the [versioning explanation](./versioning.md) first. Make pull requests to the appropriate branch.\n\nTo contribute to the manual:\n\n1. Add the Markdown file to the appropriate directory in the Docusaurus project structure.\n2. Update the sidebar configuration if needed.\n3. Use `yarn start` to preview your changes locally.\n\n## License\n\nThis project is licensed under the Apache License 2.0 — see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthreefoldtech%2Fgrid_manual","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthreefoldtech%2Fgrid_manual","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthreefoldtech%2Fgrid_manual/lists"}