{"id":23116637,"url":"https://github.com/nermalcat69/zerops-starlight","last_synced_at":"2025-07-09T06:08:22.003Z","repository":{"id":266514641,"uuid":"805217694","full_name":"nermalcat69/zerops-starlight","owner":"nermalcat69","description":":herb: Starlight Deployment on Zerops","archived":false,"fork":false,"pushed_at":"2024-12-12T02:34:09.000Z","size":191,"stargazers_count":4,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-07-09T06:08:19.799Z","etag":null,"topics":["astro","astro-template","astro-zerops","deploy","deployment","starlight-astro","starlight-zerops","zerops","zerops-deployment"],"latest_commit_sha":null,"homepage":"https://starlight.zerops.xyz","language":"MDX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nermalcat69.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-05-24T05:57:51.000Z","updated_at":"2025-02-03T18:48:39.000Z","dependencies_parsed_at":"2024-12-04T17:32:38.758Z","dependency_job_id":"e2687202-1649-4427-bd53-7013d95cf4a7","html_url":"https://github.com/nermalcat69/zerops-starlight","commit_stats":null,"previous_names":["nermalcat69/zerops-starlight-ssg","nermalcat69/zerops-starlight"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/nermalcat69/zerops-starlight","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nermalcat69%2Fzerops-starlight","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nermalcat69%2Fzerops-starlight/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nermalcat69%2Fzerops-starlight/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nermalcat69%2Fzerops-starlight/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nermalcat69","download_url":"https://codeload.github.com/nermalcat69/zerops-starlight/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nermalcat69%2Fzerops-starlight/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264403797,"owners_count":23602621,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["astro","astro-template","astro-zerops","deploy","deployment","starlight-astro","starlight-zerops","zerops","zerops-deployment"],"created_at":"2024-12-17T04:16:51.992Z","updated_at":"2025-07-09T06:08:21.986Z","avatar_url":"https://github.com/nermalcat69.png","language":"MDX","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Built with Starlight](https://astro.badg.es/v2/built-with-starlight/tiny.svg)](https://starlight.astro.build)\n\n# Starlight on Zerops - SSG\n\nThis is a template for deploying Astro's Starlight docs (SSG) to Zerops, along with a guide on how to deploy to Zerops using both their GUI and CLI.\n\n## Import Project to Zerops\n\n```yml\nproject:\n  name: astro\n\nservices:\n  - hostname: app\n    type: static\n    enableSubdomainAccess: true\n    buildFromGit: https://github.com/nermalcat69/zerops-starlight\n```\n\n## 🚀 Project Structure\n\nInside of your Astro + Starlight + Zerops project, you'll see the following folders and files:\n\n```\n.\n├── public/\n├── src/\n│   ├── assets/\n│   ├── content/\n│   │   ├── docs/\n│   │   └── config.ts\n│   └── env.d.ts\n├── astro.config.mjs\n├── package.json\n├── pnpm-lock.yaml\n├── tsconfig.json\n└── zerops.yml\n```\n\nStarlight looks for `.md` or `.mdx` files in the `src/content/docs/` directory. Each file is exposed as a route based on its file name.\n\nImages can be added to `src/assets/` and embedded in Markdown with a relative link.\n\nStatic assets, like favicons, can be placed in the `public/` directory.\n\n`zerops.yml` used for deploying to zerops via cli or gui.\n\n## Deploying Using Zerops Gui - [Go to Zerops Dashboard](https://app.zerops.io)\n\n### Importing in a new project\n\n```yaml\n# You can remove the project parameter if you're importing \n# a service into an existing project instead of creating a \n# new one\nproject:\n  name: zerops-nextjs\n\nservices:\n  - hostname: starlight\n    type: nginx@1.22\n    nginxConfig: |-\n      server {\n          listen 80 default_server;\n          listen [::]:80 default_server;\n\n          server_name _;\n          root /var/www;\n\n          location / {\n              try_files $uri $uri/ /index.html;\n          }\n\n          access_log syslog:server=unix:/dev/log,facility=local1 default_short;\n          error_log syslog:server=unix:/dev/log,facility=local1;\n      }\n    buildFromGit: https://github.com/nermalcat69/zerops-starlight-ssg\n    enableSubdomainAccess: true\n    minContainers: 1\n```\n\n\u003e 🧑‍🚀 **Confused about how to import?** Watch this video about how to import and setup a new project https://youtu.be/ZahXCIaUr_A !\n\n\u003e To import into an existing project just go to the existing project and check the left sidebar to import a service(make sure that the project parameter in import yaml).\n\n## Deploying Using Zerops Cli - [@zeropsio/zcli](https://github.com/zeropsio/zcli)\n\n### Setting up the Project Locally\n\n```bash\ngit clone https://github.com/nermalcat69/zerops-starlight\n```\n\n```bash\npnpm install\n```\n\n```bash\npnpm run build\n```\n\n### Setting up Zerops yaml\n\n```bash\nzerops:\n  - setup: starlight # Service hostname\n    build:\n      base: nodejs@18 # Technology used to build the app\n      buildCommands: # Build commands\n        - pnpm i\n        - pnpm run build\n      deploy: # Build artifacts deployed to the runtime\n        - dist/~\n      cache: # Cache for faster next round of build \n        - node_modules\n        - pnpm-lock.yaml\n```\n\nFollow these commands to deploy a project to zerops.\n\n| Command              | Action                                                                                           |\n| :------------------- | :----------------------------------------------------------------------------------------------- |\n| `zcli login \u003ctoken\u003e` | Command to login to your zerops account using your [token](https://app.zerops.io/settings/token-management). |\n| `zcli push`          | Command to push your codebase to a service (you need to have zerops.yml in your root directory).                   |\n\n## 👨‍💻 Facing Issues while deploying?\n\nIf you still find yourself stuck in the process join [Zerops Discord Server](https://discord.gg/5ptAqtpyvh) or Checkout [Zerops Docs](https://docs.zerops.io).\n\n## 👀 Want to learn more about Starlight?\n\nCheck out [Starlight’s docs](https://starlight.astro.build/), read [the Astro documentation](https://docs.astro.build), or jump into the [Astro Discord server](https://astro.build/chat).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnermalcat69%2Fzerops-starlight","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnermalcat69%2Fzerops-starlight","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnermalcat69%2Fzerops-starlight/lists"}