# WhatTheHack-Codespaces

**Repository Path**: mirrors_microsoft/WhatTheHack-Codespaces

## Basic Information

- **Project Name**: WhatTheHack-Codespaces
- **Description**: A repo to contain the student resource files & codespace lab environments to support What The Hack hackathons. https://aka.ms/wth
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-05
- **Last Updated**: 2025-09-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# What The Hack - Codespaces

This repo contains student resources and Dev Containers for What The Hack hackathons that support GitHub Codespaces.

Students should follow the instructions in the student guide for each hack here:

[What The Hack website](https://aka.ms/wth)

## Using GitHub Codespaces

A GitHub Codespace is a development environment that is hosted in the cloud that you access via a browser. All of the pre-requisite developer tools for each hack are pre-installed and available in the codespace.

You can use [GitHub Codespaces](https://docs.github.com/en/codespaces/overview) where we have a pre-configured developer environment set up and ready to go for you for some of our hacks.

### GitHub Account

You must have a GitHub account to use GitHub Codespaces. If you do not have a GitHub account, you can [Sign Up Here](https://github.com/signup).

GitHub Codespaces is available for developers in every organization. All personal GitHub.com accounts include a monthly quota of free usage each month. GitHub will provide users in the Free plan 120 core hours, or 60 hours of run time on a 2 core codespace, plus 15 GB of storage each month.

You can see your balance of available codespace hours on the [GitHub billing page](https://github.com/settings/billing/summary).

**NOTE:** Make sure you do not sign in with your enterprise managed Github account.

### Launch Codespace For Selected Hack

The GitHub Codespace for each hack will host student resources, developer CLI tools, and other data files needed for each hack. Here are the steps you will need to follow:

- Sign in to your personal GitHub account
- Click on the green **`Code`** button
- Click on the **`Codespaces`** tab
- Click the ellipsis (...) and select **`New with options...`** from the drop down menu that appears
- From the **`Dev container configuration`** drop down list, select the hackathon you want to launch
- Click the green **`Create codespace`** button

Your Codespace environment should load in a new browser tab. It will take approximately 3-5 minutes the first time you create the codespace for it to load.

- When the codespace completes loading, you should find an instance of Visual Studio Code running in your browser with the files needed for your selected hackathon.

- Follow the instructions in the student guide for your hackathon on the [What The Hack website](https://aka.ms/wth).

## Repository Contents

The contents of this repo are listed below:

### `/.devcontainer`

This folder contains the configuration for each hack's resources to be hosted in a GitHub Codespace.

### `/XXX-HackName`

These folders contain the student resources for each hack.