This is the official website for ReDoIng Mods, a Scrap Mechanic modding group. The site is built using Astro, a modern static site generator that provides excellent performance and developer experience.
- Fast static site generation with Astro
- Markdown documentation pages with MDX support
- Responsive design with Tailwind CSS
- GitHub Actions integration for automated deployment
├── public/ # Public static assets
│ ├── fonts/ # Font files
│ └── img/ # Image files
├── src/
│ ├── components/ # Reusable Astro components
│ ├── layouts/
│ │ ├── Layout.astro # Main site layout
│ │ └── DocLayout.astro # Documentation page layout
│ ├── pages/
│ │ ├── index.astro # Home page
│ │ └── docs/ # Documentation pages (Markdown)
│ └── styles/ # Global styles
├── scripts/
│ └── copy-assets.js # Script to copy assets from resources dir
└── astro.config.mjs # Astro configuration
To run the site locally:
- Clone the repository
- Install dependencies:
npm install
- Run the dev server:
npm run dev
- Open your browser to
http://localhost:4321
The documentation is written in Markdown and MDX (Markdown with JSX). To add new documentation:
- Create a new
.mdx
file insrc/pages/docs/
- Add frontmatter with the layout and meta information:
---
layout: ../../layouts/DocLayout.astro
title: Your Page Title | ReDoIng Mods
description: Description of your page
---
# Your Page Title
Content goes here...
The site is automatically deployed to GitHub Pages when changes are pushed to the main branch. The deployment is handled by GitHub Actions, with the workflow defined in .github/workflows/deploy.yml
.
This site was migrated from a static HTML site to Astro. The migration process included:
- Converting HTML to Astro components
- Setting up Markdown documentation pages
- Configuring GitHub Actions for deployment
- Creating a script to copy assets from the original resources directory