Vyriy

Vyriy Preset - SSG

Calm cloud-ready static site generation application.

This repository is a Yarn workspace monorepo with a small SSG application and shared packages for reusable UI and service boundaries. The current rendering path fetches content from a replaceable CMS adapter, renders it through a server-safe React component, and writes a static HTML page.

Create this example

npm create vyriy@latest

Choose the ssg preset.

Workspace Layout

packages/
  components/   Shared SSR-friendly React components.
  services/     Replaceable server-safe service adapters.
workspaces/
  ssg/          Static site generation workspace.

Rendering Flow

The SSG workspace renders a single static page:

  1. @p/services/cms returns page content.
  2. @p/components renders the content with the Page component.
  3. @w/ssg writes the generated document to dist/ssg/static/index.html.

The generated HTML includes compiled component styles from packages/components/page/styles.scss.

Development

Install dependencies with Yarn 4 and Node.js 24 or newer:

yarn install

Start the static generation workspace:

yarn start:ssg

Build the production SSG artifact:

yarn build:ssg

Run Storybook documentation:

yarn storybook

Validation

Run all checks:

yarn check

Run checks separately:

yarn lint
yarn build
yarn test

Focused Jest validation can target the main packages and workspace:

yarn jest workspaces/ssg packages/components packages/services --runInBand --coverage=false

Documentation

  • workspaces/ssg/README.md documents the SSG pipeline and output.
  • packages/components/README.md documents shared React components.
  • packages/services/README.md documents service adapters.

The matching doc.mdx files render these README files in Storybook.

Project Guidance

These articles describe the development approach behind this preset and provide practical guidance for evolving a project on top of it: