{"id":31581079,"url":"https://github.com/davidvkimball/astro-modular","last_synced_at":"2026-01-17T07:38:25.272Z","repository":{"id":312385731,"uuid":"1046044459","full_name":"davidvkimball/astro-modular","owner":"davidvkimball","description":"A flexible Astro blog theme designed for Obsidian users.","archived":false,"fork":false,"pushed_at":"2026-01-10T00:15:17.000Z","size":26365,"stargazers_count":126,"open_issues_count":0,"forks_count":29,"subscribers_count":3,"default_branch":"master","last_synced_at":"2026-01-10T21:29:31.335Z","etag":null,"topics":["astro","astro-template","astro-theme","astrojs","obsidian","obsidian-md","obsidian-vault"],"latest_commit_sha":null,"homepage":"https://astro-modular.netlify.app","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/davidvkimball.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":"AGENTS.md","dco":null,"cla":null},"funding":{"github":"davidvkimball","patreon":"davidvkimball"}},"created_at":"2025-08-28T05:29:37.000Z","updated_at":"2026-01-10T00:15:20.000Z","dependencies_parsed_at":null,"dependency_job_id":"c251ba67-ad7d-4e44-8a65-8c4978fc1819","html_url":"https://github.com/davidvkimball/astro-modular","commit_stats":null,"previous_names":["davidvkimball/astro-modular"],"tags_count":47,"template":true,"template_full_name":null,"purl":"pkg:github/davidvkimball/astro-modular","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidvkimball%2Fastro-modular","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidvkimball%2Fastro-modular/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidvkimball%2Fastro-modular/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidvkimball%2Fastro-modular/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/davidvkimball","download_url":"https://codeload.github.com/davidvkimball/astro-modular/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidvkimball%2Fastro-modular/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28504356,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T06:57:29.758Z","status":"ssl_error","status_checked_at":"2026-01-17T06:56:03.931Z","response_time":85,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["astro","astro-template","astro-theme","astrojs","obsidian","obsidian-md","obsidian-vault"],"created_at":"2025-10-05T21:53:10.836Z","updated_at":"2026-01-17T07:38:25.262Z","avatar_url":"https://github.com/davidvkimball.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)](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-5.15.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-20.3.0-339933?logo=node.js\u0026logoColor=white)](https://nodejs.org/)\n[![pnpm](https://img.shields.io/badge/pnpm-7.1.0-F69220?logo=pnpm\u0026logoColor=white)](https://pnpm.io/)\n[![Obsidian](https://img.shields.io/badge/Obsidian-1.11.4-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: Use GitHub Template (Recommended)\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#### Option 2: Fork the Repository\n\n1. Click the **\"Fork\"** button on the [repository page](https://github.com/davidvkimball/astro-modular)\n2. Choose where to fork the repository (your personal account or organization)\n3. Clone your forked repository:\n   ```bash\n   git clone https://github.com/your-username/your-repo-name.git\n   cd your-repo-name\n   ```\n\n### Prerequisites\n- Node.js 18.20.8\n- pnpm 7.1.0 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/obsidian-vault-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### 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- **[Astro Suite Vault Guide](src/content/posts/astro-suite-vault-modular-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\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%2Fdavidvkimball%2Fastro-modular","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdavidvkimball%2Fastro-modular","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidvkimball%2Fastro-modular/lists"}