Getting Started

Prerequisites

GitHub account with Copilot access
VS Code with the GitHub Copilot extension
GitHub Copilot CLI (for CLI demos)

Launch the Environment

Codespaces (Recommended)
Local Development

The fastest way to get started — everything is pre-configured.

Click the button below to open in Codespaces:
Wait for the devcontainer to build (includes Node 20, Docker, GitHub CLI, kubectl, Helm, Terraform, Azure CLI).
Start databases and services:
Terminal window
```
docker-compose up -d
```
Verify everything is running:
Terminal window
```
npm test
```

Clone the repository:

git clone https://github.com/edinc/octo-eshop-demo.git
cd octo-eshop-demo

Install dependencies (requires Node.js ≥ 20):
Terminal window
```
npm install
```
Start services with Docker Compose:
Terminal window
```
docker-compose up -d
```
Run tests to verify:
Terminal window
```
npm test
```

Recommended VS Code Extensions

The devcontainer installs these automatically. For local setup, install manually:

Extension	Purpose
GitHub Copilot	AI pair programming
GitHub Copilot Chat	Chat-based Copilot interaction
ESLint	Linting
Prettier	Code formatting
Prisma	Database schema editing
Docker	Container management
Kubernetes	K8s resource viewing
HashiCorp Terraform	Infrastructure as Code

Project Structure

octo-eshop-demo/
├── services/               # Microservices (npm workspaces)
│   ├── frontend/           # React SPA
│   ├── user-service/       # Authentication & profiles
│   ├── product-service/    # Bicycle catalog
│   ├── cart-service/       # Shopping cart (Redis)
│   ├── order-service/      # Order lifecycle
│   └── payment-service/    # Mock payment gateway
├── shared/                 # Shared packages
│   ├── types/              # @octo-eshop/types
│   └── utils/              # @octo-eshop/utils
├── infrastructure/         # Terraform (Azure)
├── kubernetes/             # K8s manifests
├── helm/                   # Helm charts
└── docs/                   # Architecture docs

Next Steps

Once your environment is ready, jump into any demo:

New to Copilot? Start with the End-to-End Demo for a guided tour
Running a presentation? Check Presenter Tips for pacing and narration advice
Exploring specific features? Pick any demo from the sidebar