{"id":22776284,"url":"https://github.com/gndx/ev0-astro-theme","last_synced_at":"2025-04-12T21:24:49.790Z","repository":{"id":196130622,"uuid":"693437042","full_name":"gndx/ev0-astro-theme","owner":"gndx","description":"EV0 Astro Theme is a free and open-source serverless blog template, built with Astro, Tailwind CSS, and TypeScript.","archived":false,"fork":false,"pushed_at":"2024-11-03T17:20:42.000Z","size":613,"stargazers_count":186,"open_issues_count":2,"forks_count":58,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-04T01:07:15.797Z","etag":null,"topics":["astrojs","blog","tailwindcss","typescript"],"latest_commit_sha":null,"homepage":"https://ev0.gndx.dev","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/gndx.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.MD","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},"funding":{"github":"gndx"}},"created_at":"2023-09-19T03:09:30.000Z","updated_at":"2025-03-27T21:19:25.000Z","dependencies_parsed_at":"2023-11-13T05:32:07.872Z","dependency_job_id":"0cc6b777-4b19-4588-b202-b9e4991abd03","html_url":"https://github.com/gndx/ev0-astro-theme","commit_stats":{"total_commits":60,"total_committers":11,"mean_commits":5.454545454545454,"dds":0.5333333333333333,"last_synced_commit":"77777faab2e966a42411a5b8bd0f7e9b652d4e27"},"previous_names":["gndx/ev0-astro-theme"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gndx%2Fev0-astro-theme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gndx%2Fev0-astro-theme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gndx%2Fev0-astro-theme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gndx%2Fev0-astro-theme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gndx","download_url":"https://codeload.github.com/gndx/ev0-astro-theme/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248633153,"owners_count":21136815,"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":["astrojs","blog","tailwindcss","typescript"],"created_at":"2024-12-11T19:09:13.259Z","updated_at":"2025-04-12T21:24:49.763Z","avatar_url":"https://github.com/gndx.png","language":"Astro","funding_links":["https://github.com/sponsors/gndx"],"categories":["Astro"],"sub_categories":[],"readme":"# 🚀 EV0 Astro Theme - Blog Template\n\nEV0 Astro Theme is a free and open-source serverless blog template, built with Astro, Tailwind CSS, and TypeScript. It serves as a starting point for creating your personal portfolio website or showcasing your projects online. The template is open-source and released under the MIT license, meaning you are free to use, modify, and distribute it for personal or commercial purposes.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg align=\"center\" alt=\"EV0 Astro Theme\" src=\"https://s3.amazonaws.com/gndx.dev/ev0-astro-theme.png\"/\u003e\n\u003c/p\u003e\n\n\u003ca href=\"https://astro.build\"\u003e\u003cimg src=\"https://astro.badg.es/v2/built-with-astro/tiny.svg\" alt=\"Built with Astro\" width=\"120\" height=\"20\"\u003e\u003c/a\u003e\n\n## 🔥 DEMOS\n\n- [EV0 Astro Theme - DEMO](https://ev0.gndx.dev/)\n- [GNDX - My Personal Blog (ES)](https://gndx.dev)\n\n[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/gndx/ev0-astro-theme#NODE_VERSION=18)\n\n## 🔥 Features\n\n- ✅ Minimal styling (Tailwind CSS)\n- ✅ 100/100 Lighthouse performance\n- ✅ SEO-friendly with canonical URLs and OpenGraph data\n- ✅ Dark Mode\n- ✅ Sitemap support\n- ✅ RSS Feed support\n- ✅ Markdown \u0026 MDX support\n- ✅ View Transitions\n- ✅ PWA-ready\n- ✅ Fully responsive\n- ✅ Robots.txt \u0026 Humans.txt\n- ✅ TypeScript support\n- ✅ Syntax highlighting\n- ✅ YouTube Integration\n- ✅ CLI for adding new posts\n\n## ⚓ Lighthouse Score - PWA Ready\n\n\u003cp align=\"center\"\u003e\n  \u003cimg align=\"center\" alt=\"Lighthouse Score\" src=\"https://s3.amazonaws.com/gndx.dev/EV0-astro-theme-lighthouse.png\"/\u003e\n\u003c/p\u003e\n\n\n## 👨🏻‍💻 VIP Support (optional) $25\nIncludes personalized assistance via messages/emails, customization of up to 1 feature, assistance for implementation in your hosting and deployment, and advice for future changes.  [Buy VIP Support](https://gndx.gumroad.com/l/zwaeqz). \n\n\n## 🚀 Getting Started\n\nClone this repository to your local machine using Git.\n\n```scheme\ngit clone https://github.com/gndx/ev0-astro-theme.git your-project-name\n```\n\n| Command           | Action                                       |\n| :---------------- | :------------------------------------------- |\n| `npm install`     | Installs dependencies                        |\n| `npm run dev`     | Starts local dev server at `localhost:4321`  |\n| `npm run build`   | Build your production site to `./dist/`      |\n| `npm run preview` | Preview your build locally, before deploying |\n| `npm run youtube` | Fetches the Latest YouTube Channel Videos    |\n| `npm run newpost` | Generate a New Blogpost Markdown Entry       |\n\nEdit the HTML files in the `src/pages` directory to add your projects, experiences, and personal information.\n\n## 📝 Configuration Blog\n\nTo configure your blog, edit the `src/config/config.json` file. This file contains the following options:\n\n```scheme\n{\n  \"site\": {\n    \"title\": \"EV0 Astro Theme\",\n    \"base_url\": \"https://ev0.gndx.dev/\",\n    \"base_path\": \"/\",\n    \"favicon\": \"/favicon.png\",\n    \"logo\": \"https://s3.amazonaws.com/gndx.dev/ev0-astro-logo.png\",\n    \"lang\": \"en\",\n    \"description\": \"EV0 is a free and open-source serverless blog template, built with Astro, Tailwind CSS, and TypeScript.\",\n    \"pageSize\": 6\n  },\n  \"features\": {\n    \"youtube\": true\n  },\n  \"metadata\": {\n    \"meta_author\": \"Oscar Barajas @gndx\",\n    \"meta_description\": \"EV0 is a free and open-source serverless blog template, built with Astro, Tailwind CSS, and TypeScript.\"\n  },\n  \"author\": {\n    \"name\": \"Oscar Barajas Tavares @gndx\",\n    \"avatar\": \"https://s3.amazonaws.com/gndx.dev/gndx-astro-avatar.png\",\n    \"bio\": \"EV0 is a free and open-source serverless blog template, built with Astro, Tailwind CSS, and TypeScript.\"\n  }\n}\n```\n\nThe menu is configured in the `src/config/menu.json` file. This file contains the following options:\n\n```scheme\n[\n  {\n    \"name\": \"Home\",\n    \"url\": \"/\"\n  },\n  {\n    \"name\": \"Blog\",\n    \"url\": \"/blog\"\n  },\n]\n```\n\nSocial networks are configured in the `src/config/social.json` file. This file contains the following options:\n\n```scheme\n  {\n    \"name\": \"Instagram\",\n    \"url\": \"https://instagram.com/gndx\"\n    \"svg\": \"....\"\n  }\n```\n\n## 🎥 YouTube Integration\n\nTo integrate your YouTube channel, you need to create a new file called `.env` in the root directory of your project. Then add the `CHANNEL_ID` and `API_KEY` to get the latest videos from your YouTube channel in `src/config/youtube.json`.\n\n```scheme\nnpm run youtube\n```\n\nYour YouTube API is not used in production.\n\nRequires an API KEY for YouTube API V3 - [Google Console](https://console.cloud.google.com/)\n\nYou can disable the youtube integration by modifying the `src/config/config.json`.\n\n```json\n  \"features\": {\n    \"youtube\": false\n  },\n```\n\n## 📝 Adding New Posts\n\nTo add a new post, run the following command:\n\n```scheme\nnpm run newpost\n```\n\nFollow the instructions and this will generate a new markdown file in the `src/content/blog` directory. Edit the file to add your post content.\n\n## 📂 Project Structure\n\n```\n/\n├── public/\n│   └── favicons/\n│   └── fonts/\n│   └── blog-placeholder.jpg\n│   └── favicon.png\n│   └── humans.txt\n├── scripts/\n│   └── youtube.cjs\n├── src/\n│   ├── components/\n│   ├── config/\n│   ├── content/\n│   ├── layouts/\n│   └── pages/\n│   └── styles/\n│   └── env.d.ts\n└── package.json\n└── astro.config.mjs\n└── tailwind.config.js\n└── tsconfig.json\n└── .gitignore\n```\n\n## 💻 Contributing\n\nContributions to this project are welcome. If you find a bug or have a suggestion for improvement, please open an issue or submit a pull request.\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --\u003e\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- markdownlint-disable --\u003e\n\u003ctable\u003e\n  \u003ctbody\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://gndx.io\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/10554486?v=4?s=100\" width=\"100px;\" alt=\"Oscar Barajas Tavares\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eOscar Barajas Tavares\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#doc-gndx\" title=\"Documentation\"\u003e📖\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://jhonachata.dev/\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/7337141?v=4?s=100\" width=\"100px;\" alt=\"Jhon Achata Limachi\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eJhon Achata Limachi\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#bug-dcyar\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e \u003ca href=\"#ideas-dcyar\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://erasmoh.dev\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/12125288?v=4?s=100\" width=\"100px;\" alt=\"Erasmo Hernández\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eErasmo Hernández\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#bug-erasmoh\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"http://francisco-araujo.com\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/49659840?v=4?s=100\" width=\"100px;\" alt=\"Francisco Araujo\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eFrancisco Araujo\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#design-franciscoagx\" title=\"Design\"\u003e🎨\u003c/a\u003e \u003ca href=\"#bug-franciscoagx\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"http://www.linkedin.com/in/jhoandris-baron\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/46359791?v=4?s=100\" width=\"100px;\" alt=\"Jhoandris Barón\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eJhoandris Barón\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#bug-andybaronp\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/tbody\u003e\n\u003c/table\u003e\n\n\u003c!-- markdownlint-restore --\u003e\n\u003c!-- prettier-ignore-end --\u003e\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n\n## 📃 License\n\nThis project is licensed under the MIT License. See the `LICENSE` file for details.\n\n## ☕ Support\n\nIf this project helped you learn something new, or if you're feeling particularly generous, you can buy me a coffee. It's greatly appreciated! 😊 [GitHub Sponsors](https://github.com/sponsors/gndx)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgndx%2Fev0-astro-theme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgndx%2Fev0-astro-theme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgndx%2Fev0-astro-theme/lists"}