Skip to content

Add local development setup documentation #117

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Closed
Copilot wants to merge 4 commits into from
Closed

Add local development setup documentation #117

Copilot wants to merge 4 commits into from
+284 −3

Conversation

Copy link

Copilot AI commented Dec 3, 2025 •
edited
Loading

The workshop is designed for GitHub Codespaces. Learners wanting to run on local hardware had no guidance.

Changes

  • LOCAL_SETUP.md: Comprehensive setup guide covering:

    • Prerequisites (Python 3.12+, Node.js 18+, Git) with platform-specific installation
    • Environment setup using existing scripts
    • Running application and tests
    • Project structure and development workflow
    • Troubleshooting common issues

  • README.md: Added section distinguishing Codespaces (workshop default) from local setup with reference to new guide

Quick Start

For users with prerequisites installed:

./scripts/start-app.sh
# Backend: http://localhost:5100
# Frontend: http://localhost:4321

All existing scripts work unchanged - documentation surfaces their usage for local developers.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • telemetry.astro.build
    • Triggering command: /opt/hostedtoolcache/node/22.21.1/x64/bin/node node /home/REDACTED/work/agents-in-sdlc/agents-in-sdlc/client/node_modules/.bin/astro dev --no-clearScreen (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Original prompt

This section details on the original issue you should resolve

<issue_title>Add local docs</issue_title>
<issue_description>Create an optional README to allow learners to run everything locally on their own metal</issue_description>

Comments on the Issue (you are @copilot in this section)

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Copilot AI changed the title [WIP] Add optional README for local setup instructions Add local development setup documentation Dec 3, 2025
Copilot AI requested a review from GeekTrainer December 3, 2025 19:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@GeekTrainer GeekTrainer Awaiting requested review from GeekTrainer

Assignees

@GeekTrainer GeekTrainer

Copilot code review Copilot

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Add local docs

2 participants

@GeekTrainer