You can bootstrap a new Astro project using Brutal with the following command:
Note: To use pnpm commands, you need to install pnpm first. You can install it using:
npm install -g pnpm
All commands are run from the root of the project, from a terminal:
(Here I use PNPM, no problem if you use NPM or Yarn)
Command | Action |
---|---|
pnpm install |
Installs dependencies |
pnpm dev |
Starts local dev server at localhost:3000 |
pnpm build |
Build your production site to ./dist/ |
pnpm preview |
Preview your build locally, before deploying |
pnpm astro ... |
Run CLI commands like astro add , astro preview |
pnpm astro --help |
Get help using the Astro CLI |
In this theme, I'm using UnoCSS to generate the CSS. It's a utility-first CSS framework that uses a single class to style elements. It's very easy to use and has a lot of features. It's setup to be completely compatible with TailwindCSS, with the advantage of being able to use PureCSS icons. You can always switch out UnoCSS for TailwindCSS if you want to, without breaking the general styles.
To generate the sitemap, you don't need to do anything. It's automatically generated when you build your site. You'll just need to switch out the site
on astro.config.mjs
to your own.
import { defineConfig } from "astro/config";
export default defineConfig({
site: "https://example.com",
});
The RSS feed is automatically generated from the Markdown files in the src/content/blog
folder. You can ofcourse completely change this to your own needs.
The RSS will output to https://example.com/feed.xml
by default. You can change this, by renaming src/pages/feed.xml.js
.
This directory contains all components for the blog.
This directory contains all error components.
This component is used when a page is not found.
This directory contains all generic components, reused over multiple pages.
This directory contains all components for the home page.
This directory contains all layout components. For instance, the header and footer and <head>
section.
The theme has a few colors that you can use in the included components.
- red
- blue
- green
- yellow
- pink
- purple
- orange
- teal
- cyan
- lime
- emerald
- fuchsia
- violet
- rose
- sky
- amber
More colors can be added in astro.config.mjs
in the colors
array.
If you need more from this theme, don't hesitate to open an issue or reach out to me!