{"id":50701436,"url":"https://github.com/gitoido/site","last_synced_at":"2026-06-09T09:30:24.513Z","repository":{"id":351931405,"uuid":"1211674572","full_name":"gitoido/site","owner":"gitoido","description":"A personal site","archived":false,"fork":false,"pushed_at":"2026-05-17T07:32:33.000Z","size":8959,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-05-17T09:34:50.901Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Astro","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/gitoido.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":"davidvkimball","patreon":"davidvkimball"}},"created_at":"2026-04-15T16:24:03.000Z","updated_at":"2026-05-17T07:32:36.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gitoido/site","commit_stats":null,"previous_names":["gitoido/site"],"tags_count":0,"template":false,"template_full_name":"davidvkimball/astro-modular","purl":"pkg:github/gitoido/site","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitoido%2Fsite","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitoido%2Fsite/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitoido%2Fsite/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitoido%2Fsite/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitoido","download_url":"https://codeload.github.com/gitoido/site/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitoido%2Fsite/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34101064,"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-09T02:00:06.510Z","response_time":63,"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-09T09:30:20.607Z","updated_at":"2026-06-09T09:30:24.507Z","avatar_url":"https://github.com/gitoido.png","language":"Astro","funding_links":["https://github.com/sponsors/davidvkimball","https://patreon.com/davidvkimball"],"categories":[],"sub_categories":[],"readme":"# Astro Modular\n\nA flexible [Astro](https://astro.build) blog theme designed for [Obsidian](https://obsidian.md) users. \n\n[![Alt](https://github.com/user-attachments/assets/612b2171-d141-412b-a891-5b1caa1447b8 \"Astro Modular theme shown off in 3 screenshots, with the left screenshot showing the homepage, the top right showing the bottom of a post, and the bottom right showing a minimal homepage\")](https://astro.build/themes/details/astro-modular/)\n\n## Made with Vault CMS\n\nUse Obsidian as a CMS with [Vault CMS](https://github.com/davidvkimball/vault-cms).\n\n![Alt](https://github.com/user-attachments/assets/3db459e6-6b9a-4c37-b86d-0f661e88e204 \"Astro Modular Obsidian vault\")\n\n## Stats\n\n![Alt](https://repobeats.axiom.co/api/embed/66fe41c94d95b32b92c1a2fd8d6dc83d386bc10a.svg \"Repobeats analytics image\")\n\n![Alt](https://github.com/user-attachments/assets/e09c8ee1-6f91-46d6-84a5-e2d8a35c1e14 \"Pagespeed scores\")\n\n\n### Status\n[![Netlify Status](https://api.netlify.com/api/v1/badges/3f849f7a-71e6-463b-84af-01c523012348/deploy-status)](https://app.netlify.com/sites/astro-modular/deploys)\n[![GitHub last commit](https://img.shields.io/github/last-commit/davidvkimball/astro-modular/master)](https://github.com/davidvkimball/astro-modular)\n[![GitHub commit activity](https://img.shields.io/github/commit-activity/m/davidvkimball/astro-modular)](https://github.com/davidvkimball/astro-modular)\n\n### Tech Stack\n[![Astro](https://img.shields.io/badge/Astro-6.0.0--beta.1-FF5D01?logo=astro\u0026logoColor=white)](https://astro.build/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.9.2-3178C6?logo=typescript\u0026logoColor=white)](https://www.typescriptlang.org/)\n[![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-3.4.17-38B2AC?logo=tailwind-css\u0026logoColor=white)](https://tailwindcss.com/)\n[![Node.js](https://img.shields.io/badge/Node.js-24.13.0-339933?logo=node.js\u0026logoColor=white)](https://nodejs.org/)\n[![pnpm](https://img.shields.io/badge/pnpm-10.29.3-F69220?logo=pnpm\u0026logoColor=white)](https://pnpm.io/)\n[![Obsidian](https://img.shields.io/badge/Obsidian-1.12.2-7C3AED?logo=obsidian\u0026logoColor=white)](https://obsidian.md/)\n\n## Why Astro Modular?\n\n- **Obsidian As A CMS**: Works with Obsidian out of the box (built upon [Vault CMS](https://github.com/davidvkimball/vault-cms)), write and publish instantly\n- **Highly Customizable**: Every feature can be enabled/disabled independently\n- **Performance-Focused**: Assets are highly optimized for lightning-fast loading\n- **SEO-Ready**: Automatic sitemap, RSS feed, and Open Graph image generation\n\n## Features\n\n- [x] **Custom Themes** \n- [x] **Feature Toggle Control** \n- [x] **Dark/Light Mode** \n- [x] **Search \u0026 Command Palette** \n- [x] **Wikilinks \u0026 Linked Mentions** \n- [x] **Obsidian-Style Callouts**\n- [x] **Obsidian Embeds Files**\n- [x] **Folder-Based Posts** \n- [x] **Multiple Content Types**\n- [x] **Image Optimization** \n- [x] **Automatic Feed Generation**\n- [x] **Table of Contents** \n- [x] **Smooth Scroll \u0026 Page Transitions** \n- [x] **Image Gallery \u0026 Lightbox** \n- [x] **Reading Time \u0026 Word Count** \n- [x] **Tagging**\n- [x] **Graph View**\n- [x] **Mermaid Diagrams**\n- [x] **LaTeX \u0026 Math Rendering** \n- [x] **Custom Typography**\n- [x] **Profile Picture** \n- [x] **Comments**\n\n## Quick Start\n\n[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/davidvkimball/astro-modular)\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https://github.com/davidvkimball/astro-modular)\n[![Deploy to Cloudflare](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/davidvkimball/astro-modular)\n\n### Get the Code\n\nChoose one of the following methods to get started:\n\n#### Option 1: CLI (Recommended)\n\n```bash\npnpm create astro-modular my-blog\ncd my-blog\n```\n\n[![npm version](https://img.shields.io/npm/v/create-astro-modular)](https://www.npmjs.com/package/create-astro-modular)\n\nThis downloads the latest template, removes dev-only files, and installs dependencies automatically. Also works with `npm create astro-modular my-blog`.\n\n#### Option 2: Use GitHub Template\n\n1. Click the **\"Use this template\"** button on the [repository page](https://github.com/davidvkimball/astro-modular)\n2. Select **\"Create a new repository\"**\n3. Choose your repository name and settings\n4. Click **\"Create repository from template\"**\n5. Clone your new repository:\n   ```bash\n   git clone https://github.com/your-username/your-repo-name.git\n   cd your-repo-name\n   ```\n\n\n\n### Prerequisites\n- Node.js 24.13.0+\n- pnpm 10.29.3+ or npm 9.6.5+\n\n\u003e [!NOTE]\n\u003e While this theme works great with any markdown editor, it's specifically optimized for Obsidian use. See the [Astro Suite Vault Guide](src/content/posts/vault-cms-guide.md) for Obsidian-specific features.\n\n### Setup\n\n1. **Install pnpm (if you don't have it):**\n   ```bash\n   npm install -g pnpm\n   ```\n\n2. **Install dependencies:**\n   ```bash\n   pnpm install\n   ```\n\n3. **Preview:**\n   ```bash\n   pnpm dev\n   ```\n   Your blog will be available at `http://localhost:5000`\n\n4. **Build for production:**\n   ```bash\n   pnpm build\n   ```\n\n### Updating the theme\n\nTo pull the latest theme release (framework files, Astro, config) while keeping your content and assets:\n\n```bash\npnpm run update\n```\n\nThis downloads the latest release from GitHub, replaces framework files, restores your `src/content` and profile/favicon assets, then runs `pnpm install`. After updating, open Obsidian and use **Astro Modular Settings → Apply all settings** so your saved settings are written to the new `config.ts` if needed.\n\n### Configuration\n\nEdit `src/config.ts` to customize your site - change the theme, enable/disable features, and configure all settings.\n\n## Deployment\n\nSet your deployment platform once in `src/config.ts` under `deployment.platform` (\"netlify\", \"vercel\", \"github-pages\", or \"cloudflare-workers\"). The build process automatically generates the correct configuration files for your chosen platform - no environment variables needed!\n\n## Documentation\n\nFor detailed guides, see the included blog posts:\n- **[Getting Started](src/content/posts/getting-started.md)** - complete setup and workflow guide\n- **[Formatting Reference](src/content/posts/formatting-reference.md)** - comprehensive formatting reference  \n- **[Vault CMS Guide](src/content/posts/vault-cms-guide.md)** - Obsidian vault walkthrough\n- **[Obsidian Embeds Demo](src/content/posts/obsidian-embeds-demo.md)** - Obsidian embed examples\n\n**For AI Agents \u0026 Developers:** See [AGENTS.md](AGENTS.md) for comprehensive technical documentation.\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=davidvkimball/astro-modular\u0026type=date\u0026legend=top-left)](https://www.star-history.com/#davidvkimball/astro-modular\u0026type=date\u0026legend=top-left)\n\n## Acknowledgments \n\n[Spaceship Astro theme](https://github.com/aitorllj93/astro-theme-spaceship) for the graph view functionality upon which this theme's is based.\n\n[ogImage.click](https://ogimage.click/) to generate the open graph image used for this theme.\n\n## Contributing\n\nThis is an open-source project. Feel free to submit feature requests, report bugs, or contribute improvements.\n\nIf you are contributing code back to the theme itself, please fork the repository and submit a Pull Request. **Do not fork the repository if you are just building your own site from this template.**\n\n## License\n\n[MIT License](https://github.com/davidvkimball/astro-modular?tab=MIT-1-ov-file)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitoido%2Fsite","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitoido%2Fsite","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitoido%2Fsite/lists"}