Merge pull request #5 from ESIPFed/copilot/create-dev-container-config

Add Development Container configuration for GitHub Codespaces

Author: amfriesz

.devcontainer/README.md

@@ -0,0 +1,51 @@
+# Development Container Configuration
+
+This directory contains the configuration for the GitHub Codespaces development container.
+
+## What's Included
+
+This development container provides a complete environment for working with the AI Readiness Primer Quarto website:
+
+- **Base Image**: R development environment (rocker-org/devcontainer/r-ver:4)
+- **Quarto CLI**: Latest version installed via dev container features
+- **VS Code Extensions**:
+  - `quarto.quarto` - Official Quarto extension for VS Code
+  - `ms-vscode.live-server` - Live server for quick previews
+- **Port Forwarding**: Automatic forwarding of port 4848 (Quarto preview server)
+- **Post-Create Check**: Runs `quarto check` to verify installation
+
+## Using the Dev Container
+
+### With GitHub Codespaces
+
+1. Navigate to the repository on GitHub
+2. Click the "Code" button
+3. Select the "Codespaces" tab
+4. Click "Create codespace on main"
+
+The container will automatically set up, and you'll be ready to work within a few minutes.
+
+### With VS Code Locally
+
+If you have Docker installed and the "Dev Containers" extension for VS Code:
+
+1. Open the repository folder in VS Code
+2. Press `F1` and select "Dev Containers: Reopen in Container"
+3. Wait for the container to build and start
+
+## Working with Quarto
+
+Once your dev container is running, you can use standard Quarto commands:
+
+```bash
+# Preview the site (accessible on forwarded port 4848)
+quarto preview
+
+# Render the site
+quarto render
+
+# Check Quarto installation
+quarto check
+```
+
+The preview server will be automatically accessible through the forwarded port.

.devcontainer/devcontainer.json

@@ -0,0 +1,35 @@
+{
+  "name": "AI Readiness Primer - Quarto Development",
+  "image": "ghcr.io/rocker-org/devcontainer/r-ver:4",
+  
+  "features": {
+    "ghcr.io/rocker-org/devcontainer-features/quarto-cli:1": {
+      "version": "latest"
+    }
+  },
+
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "quarto.quarto",
+        "ms-vscode.live-server"
+      ],
+      "settings": {
+        "terminal.integrated.shell.linux": "/bin/bash"
+      }
+    }
+  },
+
+  "forwardPorts": [4848],
+
+  "portsAttributes": {
+    "4848": {
+      "label": "Quarto Preview",
+      "onAutoForward": "notify"
+    }
+  },
+
+  "postCreateCommand": "quarto check",
+
+  "remoteUser": "vscode"
+}

README.md

@@ -12,11 +12,23 @@ The published site is available at: https://esipfed.github.io/ai-readiness-prime
 
 ## Local Development
 
-### Prerequisites
+### Using GitHub Codespaces (Recommended)
+
+The easiest way to get started is using GitHub Codespaces, which provides a pre-configured development environment:
+
+1. Click the "Code" button on the repository page
+2. Select "Codespaces" tab
+3. Click "Create codespace on main"
+
+The development container will automatically set up Quarto and all necessary tools. Once ready, you can use the terminal to run Quarto commands.
+
+### Local Setup
+
+#### Prerequisites
 
 - [Quarto](https://quarto.org/docs/get-started/) installed on your system
 
-### Building Locally
+#### Building Locally
 
 To preview the site locally: