How jfeelgoodofficial/playcentralgames works
1. This repository is a small static website, not a multi-service application. The top-level runtime surface is a set of HTML pages: index.html, game.html, and slingshot-carnival.html, supported by an images/ asset directory.
2. The site appears to be centered on an interactive game experience. game.html is the obvious gameplay entry point, while index.html is the public landing page and slingshot-carnival.html is likely a themed or alternate content page. There is no separate backend, API layer, or database in the repository.
3. Asset management is simple and local. Visual resources live under images/, and the presence of robots.txt and sitemap.xml indicates the site is intended to be crawlable and publicly indexed.
4. Automated quality checks are split into a few focused scripts in scripts/: check-images.js and check-seo-files.js. These are repository-level guardrails rather than app runtime code, and they validate media/SEO-related correctness.
5. End-to-end verification is handled with Playwright. The tests/ directory contains browser tests for core user journeys and site quality: homepage.e2e.ts, card-game.e2e.ts, accessibility.e2e.ts, and seo.e2e.ts. This suggests the architecture is validated from the browser outward, which fits a static site with client-side interaction.
6. Tooling is strongly lint- and standards-oriented. The repo includes ESLint, Prettier, Stylelint, and HTML validation config files, plus lighthouserc.json for performance/SEO auditing. These tools form a non-runtime “quality pipeline” around the site.
7. CI is defined in .github/workflows/ci.yml, so the validation flow is automated in GitHub Actions. The CI layer likely runs formatting/linting, custom checks, and Playwright tests before changes are accepted.
8. Deployment is configured for Vercel via vercel.json. That implies the site is deployed as static hosting or edge-served HTML, with no custom server code in this repository.
9. The important architectural boundary is between content/runtime and verification/tooling. The runtime side is just HTML pages plus static assets; the supporting side is tests, validators, and CI/CD scripts that ensure accessibility, SEO, and image/file integrity.
10. For a diagram, the main nodes should be: browser/user traffic into the static HTML pages, shared image assets, crawlability files (robots.txt, sitemap.xml), test/validation tooling, CI automation in GitHub Actions, and deployment to Vercel. That is the complete system visible from this repository.
Main entry points: tests Playwright · ci.yml CI · images Images · seo.e2e.ts SEO e2e
Components 18
Site runtime
Static pages and assets served to visitors
Quality pipeline
Checks, tests, and CI around the site
- Playwright · End-to-end browser verification
tests - Home e2e · Homepage journey checks
tests/homepage.e2e.ts - Game e2e · Gameplay journey checks
tests/card-game.e2e.ts - A11y e2e · Accessibility checks
tests/accessibility.e2e.ts - SEO e2e · Search and metadata checks
tests/seo.e2e.ts - Image check · Validates image assets
scripts/check-images.js - SEO check · Validates crawl files
scripts/check-seo-files.js - Linting · ESLint, Prettier, Stylelint, HTML validation, Lighthouse
- CI · Automated validation pipeline
.github/workflows/ci.yml
Connections 26
- Visitor → Static site: browse · Users access the site
- Static site → Home: entry · Landing page
- Static site → Game: entry · Gameplay page
- Static site → Carnival: entry · Alternate themed page
- Home → Images: uses · Home page loads shared visuals
- Game → Images: uses · Game page loads shared visuals
- Carnival → Images: uses · Themed page loads shared visuals
- Static site → Robots: crawl · Public indexing metadata
- Static site → Sitemap: crawl · Public indexing metadata
- Playwright → Home e2e: includes · Homepage verification
- Playwright → Game e2e: includes · Gameplay verification
- Playwright → A11y e2e: includes · Accessibility verification
- Playwright → SEO e2e: includes · SEO verification
- Home e2e → Home: covers · Exercises the landing page
- Game e2e → Game: covers · Exercises the gameplay page
- A11y e2e → Static site: audits · Checks site accessibility
- SEO e2e → Robots: audits · Checks crawlability files
- SEO e2e → Sitemap: audits · Checks crawlability files
- Image check → Images: validates · Checks image assets
- SEO check → Robots: validates · Checks SEO files
- SEO check → Sitemap: validates · Checks SEO files
- CI → Linting: runs · Formatting and linting gates
- CI → Image check: runs · Repository guardrail
- CI → SEO check: runs · Repository guardrail
- CI → Playwright: runs · Browser-level verification
- Vercel → Static site: hosts · Static deployment target