ayco.io-astro/README.md

Astro SSG for my personal site

Background

This is the project for generating the static files for my personal site ayo.ayco.io built with Astro SSG.

Development

You need node and pnpm.

# clone project
$ git clone https://git.ayo.run/ayo/ayco.io-astro

# go into project dir
$ cd ./ayco.io-astro

# install deps
$ pnpm i

Commands

Command	Action
pnpm run dev	start dev server
pnpm run build	generate static files to dist directory
pnpm run deploy	upload to my server
pnpm run prep:now	back up and clear current now page constants

Deployment

For the script npm run deploy, you need to add an environmental variable named HOST containing the IP address of the host server. This will scp the build files into the server.

You can do this by adding a .env file with the following content (replace the IP):

# .env
HOST=123.456.789.00

There is a service worker (src/sw.mjs) that caches assets on client browsers. For cache invalidation, the version property in package.json is used. Increment the version via npm version patch (or minor, major) if there is a significant change in the website's assets.

If you want to run build before deploying, do npm run build:deploy

---

Just keep building.
~Ayo