Checkpoint

A minimal personal homepage built with Astro.

This project is AI-friendly and was mostly created with AI assistance, then refined as a lightweight, maintainable Astro site.

This project is a lightweight public hub for:

• a self-hosted Gitea instance
• a GitHub mirror
• gaming profiles for Steam, PlayStation, Xbox, and Nintendo Switch

It is intentionally simple: one page, reusable Astro components, minimal JavaScript, and a dark, modern design.

Stack

• Astro
• Font Awesome Free
• Plain CSS

Getting Started

Install dependencies:

npm install

Start the development server:

npm run dev

Build for production:

npm run build

Preview the production build:

npm run preview

Customization

Most content lives in src/data/links.ts.

Update this file to change:

• hero title and subtitle
• hostname/signature
• Gitea and GitHub links
• gaming profile links

Project Structure

.
├── public/
│   └── favicon.svg
├── src/
│   ├── components/
│   │   ├── Card.astro
│   │   └── Section.astro
│   ├── data/
│   │   └── links.ts
│   ├── layouts/
│   │   └── Layout.astro
│   ├── pages/
│   │   └── index.astro
│   └── styles/
│       └── global.css
├── .dockerignore
├── .gitignore
├── astro.config.mjs
├── package.json
├── README.md
└── tsconfig.json

Notes

• The page is fully static and optimized for minimal client-side JavaScript.
• Icons are provided through Font Awesome brand icons.
• Styling is handled in src/styles/global.css.
• Content is primarily configured through src/data/links.ts to stay easy for both humans and AI agents to edit.
• Contributor guidance for AI/code agents lives in AGENTS.md.

License

MIT