Repository files navigation

EV0 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.

• EV0 Astro Theme - DEMO
• GNDX - My Personal Blog (ES)

• ✅ Minimal styling (Tailwind CSS)
• ✅ 100/100 Lighthouse performance
• ✅ SEO-friendly with canonical URLs and OpenGraph data
• ✅ Sitemap support
• ✅ RSS Feed support
• ✅ Markdown & MDX support
• ✅ PWA-ready
• ✅ Fully responsive
• ✅ Robots.txt & Humans.txt
• ✅ TypeScript support
• ✅ Syntax highlighting
• ✅ YouTube Integration
• ✅ CLI for adding new posts

Clone this repository to your local machine using Git.

git clone https://github.com/gndx/ev0-astro-theme.git your-project-name

Edit the HTML files in thesrc/pages directory to add your projects, experiences, and personal information.

To configure your blog, edit thesrc/config/config.json file. This file contains the following options:

{"site": {"title":"EV0 Astro Theme","base_url":"https://ev0.gndx.io","base_path":"/","favicon":"/favicon.png","logo":"https://s3.amazonaws.com/gndx.dev/ev0-astro-logo.png","lang":"en","description":"EV0 is a free and open-source serverless blog template, built with Astro, Tailwind CSS, and TypeScript.","pageSize": 6  },"metadata": {"meta_author":"Oscar Barajas @gndx","meta_description":"EV0 is a free and open-source serverless blog template, built with Astro, Tailwind CSS, and TypeScript."  },"author": {"name":"Oscar Barajas Tavares @gndx","avatar":"https://s3.amazonaws.com/gndx.dev/gndx-astro-avatar.png","bio":"EV0 is a free and open-source serverless blog template, built with Astro, Tailwind CSS, and TypeScript."  }}

The menu is configured in thesrc/config/menu.json file. This file contains the following options:

[  {"name":"Home","url":"/"  },  {"name":"Blog","url":"/blog"  },]

Social networks are configured in thesrc/config/social.json file. This file contains the following options:

  {"name":"Instagram","url":"https://instagram.com/gndx""svg":"...."  }

To integrate your YouTube channel, you need to create a new file called.env in the root directory of your project. Then add theCHANNEL_ID andAPI_KEY to get the latest videos from your YouTube channel insrc/config/youtube.json.

npm run youtube

Your YouTube API is not used in production.

Requires an API KEY for YouTube API V3 -Google Console

To add a new post, run the following command:

npm run newpost

Follow the instructions and this will generate a new markdown file in thesrc/content/blog directory. Edit the file to add your post content.

/├── public/│   └── favicons/│   └── fonts/│   └── blog-placeholder.jpg│   └── favicon.png│   └── humans.txt├── scripts/│   └── newpost.cjs│   └── youtube.cjs├── src/│   ├── components/│   ├── config/│   ├── content/│   ├── layouts/│   └── pages/│   └── styles/│   └── env.d.ts└── package.json└── astro.config.mjs└── tailwind.config.js└── tsconfig.json└── .gitignore

• 1.0.0: Initial Release 🚀 - (18/09/23)

Contributions 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.

This project is licensed under the MIT License. See theLICENSE file for details.

If 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