Skip to content

Build the Waywallen website with Astro and Material Design 3 - #1

Open
CatSema wants to merge 13 commits into
waywallen:mainfrom
CatSema:feat/astro-material3-site
Open

Build the Waywallen website with Astro and Material Design 3#1
CatSema wants to merge 13 commits into
waywallen:mainfrom
CatSema:feat/astro-material3-site

Conversation

@CatSema

@CatSema CatSema commented Aug 20, 2026

Copy link
Copy Markdown

Summary

This PR replaces the placeholder GitHub Pages site with a complete multilingual Astro website for Waywallen.

The new site presents Waywallen’s features, screenshots, plugins, installation options, desktop integrations, troubleshooting information, FAQ, contributors, and project support links in a responsive Material Design 3 interface.

Highlights

  • Rebuilt the website with Astro and static output
  • Added English, Russian, and Simplified Chinese localizations
  • Added automatic locale detection with persistent manual selection
  • Added responsive desktop and mobile navigation
  • Added light and dark themes with system-theme detection
  • Added dedicated pages for:
    • Features
    • Screenshots
    • Plugins
    • Downloads
    • Documentation
    • Installation
    • Desktop environment integration
    • Wallpaper Engine compatibility
    • Troubleshooting
    • FAQ
    • Contributors
  • Added KDE Plasma, GNOME, Hyprland, Niri, Wayfire, Sway, and COSMIC compatibility information
  • Expanded plugin descriptions based on the Waywallen documentation
  • Added project developer, website author, sponsorship, contribution, bug tracker, and Discord links
  • Added a build-time contributors list from the GitHub API with an offline fallback
  • Added localized metadata, canonical URLs, hreflang links, sitemap generation, robots.txt, favicon, and social preview image
  • Preserved the custom domain, Flathub verification file, and .nojekyll
  • Centralized external links and asset paths
  • Split translations into independent typed modules
  • Added formatting, Astro validation, CI, and GitHub Pages deployment workflows

Validation

  • npm run format:check
  • npm run check
  • npm run build
  • 0 Astro/TypeScript errors or warnings
  • 39 static pages generated
  • Desktop and mobile layouts verified
  • English, Russian, and Simplified Chinese routes verified
  • Locale selection and automatic locale detection verified
  • GitHub Pages artifact verified to contain:
    • CNAME
    • .nojekyll
    • 404.html
    • sitemap
    • Flathub verification file

Deployment workflow

The deployment workflow follows the official Astro and GitHub Pages configuration:

  • withastro/action@v6 builds and uploads the Pages artifact
  • actions/deploy-pages@v4 publishes it
  • pages: write and id-token: write permissions are enabled
  • deployment uses the standard github-pages environment

The editor warning that github-pages is not a valid environment value is a schema false positive. github-pages is the environment name recommended by GitHub.

Maintainer steps after merging

  1. Open Settings → Pages.
  2. Under Build and deployment, select GitHub Actions as the publishing source.
  3. Configure waywallen.org as the custom domain in the Pages settings.
  4. Enable Enforce HTTPS after GitHub validates the domain.
  5. Confirm that the first Deploy to GitHub Pages workflow run succeeds.
  6. Optionally add a deployment protection rule to the automatically created github-pages environment so that only main can deploy.
  7. Verify the deployed /, /ru/, /zh-cn/, and Flathub verification URLs.

No repository secrets are required for the current deployment workflow.

изображение изображение изображение изображение изображение изображение изображение изображение изображение

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant