Skip to content

1-hour workshop: Specify supported runtimes and align cross-platform prerequisites #258

Open

Description

@softchris

Problem

content/1-hour/README.md requires only a "recent" Node.js and Python version. The current Astro dependency requires Node.js >=22.12.0, but this requirement is not declared in app/client/package.json or stated in the workshop. The same prerequisite section says a Bash-capable shell is required and tells Windows learners to install WSL or Git Bash, while content/1-hour/0-setup.md provides a native PowerShell startup path.

A learner can satisfy the written prerequisites and still fail during setup, or install an unnecessary shell on Windows.

Suggested change

Declare and document supported runtime versions, and describe Bash and PowerShell as alternative setup paths.

Acceptance criteria

  • app/client/package.json declares the supported Node.js engine.
  • The one-hour prerequisites state a concrete Node.js minimum or supported LTS release and a tested Python range.
  • Native Windows learners are told that PowerShell is sufficient when using start-app.ps1.
  • Bash/WSL guidance is limited to the Bash script path.
  • Setup is tested using each documented shell path.

Activity

  1. scubaninja commented on Sep 18, 2026

    @scubaninja
    Collaborator

    Backlog review priority: P1. Tagging @scubaninja for visibility and follow-up.

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    priority: P1High: core correctness or reliability

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions