{"id":15505309,"url":"https://github.com/hasparus/zaduma","last_synced_at":"2025-04-11T16:51:03.102Z","repository":{"id":63225601,"uuid":"544665441","full_name":"hasparus/zaduma","owner":"hasparus","description":"astro template","archived":false,"fork":false,"pushed_at":"2024-06-02T19:58:25.000Z","size":8570,"stargazers_count":68,"open_issues_count":11,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-10-19T05:18:14.122Z","etag":null,"topics":["astro","solidjs","tailwindcss","vercel-og"],"latest_commit_sha":null,"homepage":"https://zaduma.vercel.app","language":"TypeScript","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/hasparus.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":"2022-10-03T02:18:39.000Z","updated_at":"2024-10-07T17:50:44.000Z","dependencies_parsed_at":"2024-06-01T23:08:22.935Z","dependency_job_id":"47a10b7e-ff86-403c-8501-d86541ca6ad9","html_url":"https://github.com/hasparus/zaduma","commit_stats":{"total_commits":448,"total_committers":5,"mean_commits":89.6,"dds":"0.024553571428571397","last_synced_commit":"94b648983b62ec21e031388c0eaa9f8e789c975b"},"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hasparus%2Fzaduma","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hasparus%2Fzaduma/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hasparus%2Fzaduma/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hasparus%2Fzaduma/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hasparus","download_url":"https://codeload.github.com/hasparus/zaduma/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248442963,"owners_count":21104308,"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","solidjs","tailwindcss","vercel-og"],"created_at":"2024-10-02T09:22:34.084Z","updated_at":"2025-04-11T16:51:03.077Z","avatar_url":"https://github.com/hasparus.png","language":"TypeScript","funding_links":[],"categories":["Noted","TypeScript"],"sub_categories":[],"readme":"# zaduma\n\n_an [Astro] starter template for understated personal websites_\n\n**Built with:**\n\n- [SolidJS]\n- [MDX], [Remark] and [Unified]\n- [Shiki Twoslash][shiki-twoslash]\n- [Tailwind CSS][tailwind-css]\n- Vercel and [Vercel OG][vercel-og]\n- [GitHub Actions][github-actions]\n\n[astro]: https://astro.build/\n[solidjs]: https://www.solidjs.com/\n[mdx]: https://mdxjs.com/\n[remark]: https://github.com/remarkjs/remark\n[unified]: https://unifiedjs.com/\n[shiki-twoslash]: https://github.com/shikijs/twoslash\n[tailwind-css]: https://tailwindcss.com/\n[vercel-og]:\n  https://vercel.com/blog/introducing-vercel-og-image-generation-fast-dynamic-social-card-images\n[github-actions]: https://github.com/features/actions\n\n## 🏎️ Usage TLDR\n\n1. Click \u003ckbd\u003eUse this template\u003c/kbd\u003e to create a new repo.\n2. Set [`VERCEL_TOKEN`], `VERCEL_PROJECT_ID`, and [`VERCEL_ORG_ID`] secrets to\n   deploy to Vercel from GHA (enables access to git history).\n3. Add `OG_IMAGE_SECRET` to secure your OG image endpoint.\n\n_[See full usage instructions.](#-usage)_\n\n## 🏛 Project Structure\n\nInside of your Astro project, you'll see the following folders and files:\n\n\u003cpre\u003e\n\u003ccode\u003e\n├── posts/\n│   └── rebuilding-a-blog.mdx — \u003ci\u003eposts written in \u003ca href=\"https://mdxjs.com/\"\u003eMDX\u003c/a\u003e\u003c/i\u003e\n├── public/ — \u003ci\u003estatic assets apart from images\u003c/i\u003e\n├── src/\n│   ├── build-time/* — \u003ci\u003eremark plugins\u003c/i\u003e\n│   ├── global-styles/* — \u003ci\u003efonts, body and prose styles\u003c/i\u003e\n│   ├── layouts/\n│   │   ├── BaseLayout.astro — \u003ci\u003eUI shared between all pages\u003c/i\u003e\n│   │   └── PostLayout.astro — \u003ci\u003elayout for all posts\u003c/i\u003e\n│   ├── lib/* — \u003ci\u003ereusable utils and UI components\u003c/i\u003e\n│   ├── images/* — \u003ci\u003epictures (need to be here to be optimized by Astro Image)\u003c/i\u003e\n│   ├── pages/\n│   │   ├── [path].astro — \u003ci\u003eAstro dynamic route for posts, supplies MDX components\u003c/i\u003e\n│   │   └── index.astro — \u003ci\u003eindex page, lists all posts\u003c/i\u003e\n│   ├── env.d.ts\n│   └── types.ts\n├── astro.config.ts\n├── package.json\n├── postcss.config.cjs\n├── tailwind.config.cjs — \u003ci\u003eTailwind config, colors, fonts\u003c/i\u003e\n└── tsconfig.json\n\u003c/code\u003e\n\u003c/pre\u003e\n\n## 🧞 Commands\n\nAll commands are run from the root of the project, from a terminal:\n\n| Command                 | Action                                           |\n| :---------------------- | :----------------------------------------------- |\n| `pnpm install`          | Installs dependencies                            |\n| `pnpm run dev`          | Starts local dev server at `localhost:3000`      |\n| `pnpm run build`        | Build your production site to `./dist/`          |\n| `pnpm run preview`      | Preview your build locally, before deploying     |\n| `pnpm run astro ...`    | Run CLI commands like `astro add`, `astro check` |\n| `pnpm run astro --help` | Get help using the Astro CLI                     |\n\n## 👌 Usage\n\n1. Click \u003ckbd\u003eUse this template\u003c/kbd\u003e to create a new repo.\n2. Clone the repository, install with `pnpm install` and run with `pnpm dev`.\n3. Style it and personalize however you like 💅\n4. Set [`VERCEL_TOKEN`], `VERCEL_PROJECT_ID`, and [`VERCEL_ORG_ID`] secrets to\n   deploy to Vercel from GHA (what enables access to git history).\n   ([_Settings→Secrets_](https://github.com/hasparus/zaduma/settings/secrets/actions))\n\n   - Alternatively — if all your blog posts have a `date` in frontmatter, you\n     don't need to deploy through _workflows/ci.yml_. Feel free to remove the\n     deploy steps from the YML file and connect Vercel/Netlify integration. Go\n     to `derivedTitleAndDatePlugin` function and remove `execSync(\"git log\")`\n     from it. (TODO: Can we make it more convenient?)\n\n5. Generate a passphrase for `OG_IMAGE_SECRET` to secure your OG image endpoint,\n   and add it to\n   [Actions Secrets](\u003c(https://github.com/hasparus/zaduma/settings/secrets/actions)\u003e).\n\n[`vercel_token`]: https://vercel.com/account/tokens\n[`vercel_org_id`]: https://vercel.com/account#your-id\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhasparus%2Fzaduma","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhasparus%2Fzaduma","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhasparus%2Fzaduma/lists"}