Astro Starter Kit: Blog

npm create astro@latest -- --template blog

🧑‍🚀 Seasoned astronaut? Delete this file. Have fun!

Features:

✅ Minimal styling (make it your own!)
✅ 100/100 Lighthouse performance
✅ SEO-friendly with canonical URLs and OpenGraph data
✅ Sitemap support
✅ RSS Feed support
✅ Markdown & MDX support

🚀 Project Structure

Inside of your Astro project, you'll see the following folders and files:

├── public/
├── src/
│   ├── components/
│   ├── content/
│   ├── layouts/
│   └── pages/
├── astro.config.mjs
├── README.md
├── package.json
└── tsconfig.json

Astro looks for .astro or .md files in the src/pages/ directory. Each page is exposed as a route based on its file name.

There's nothing special about src/components/, but that's where we like to put any Astro/React/Vue/Svelte/Preact components.

The src/content/ directory contains "collections" of related Markdown and MDX documents. Use getCollection() to retrieve posts from src/content/blog/, and type-check your frontmatter using an optional schema. See Astro's Content Collections docs to learn more.

Any static assets, like images, can be placed in the public/ directory.

🧞 Commands

All commands are run from the root of the project, from a terminal:

Command	Action
`npm install`	Installs dependencies
`npm run dev`	Starts local dev server at `localhost:4321`
`npm run build`	Build your production site to `./dist/`
`npm run preview`	Preview your build locally, before deploying
`npm run astro ...`	Run CLI commands like `astro add`, `astro check`
`npm run astro -- --help`	Get help using the Astro CLI

👀 Want to learn more?

Check out our documentation or jump into our Discord server.

Credit

This theme is based off of the lovely Bear Blog.

Deployment

Install flyctl

npm install -g @fly/fly

flyctl auth login

If this is the first time to deploy, create a new app with the following command

flyctl launch

This command creates some files needed to deploy the application with fly.io from the local terminal: fly.toml, Dockerfile and .dockerignore.

Make sure that in the fly.toml file the app name is same as the one set in the fly.io dashboard.

app = 'astro-blog-fly'

Also make sure that the internal port is set to the port that the Astro server is running on. In this case it is 4321.

[http_service]
  internal_port = 4321

Make sure the settings in these files are correct.

Deploy the app. By Pushing to the main branch or running the following command.

```bash
flyctl deploy

create a volume in fly app

fly volumes create db

agree to the prompt to create a single volume and select same region as the app, as you can read in the fly dashboard.