Welcome to Copilot Adventures! This series of coding adventures is all about learning new concepts and languages by using GitHub Copilot to help you write code. Let's get started!

To get started, enter the "adventure arena" by clicking the button below. This will create a GitHub Codespace that you can work in. Once it loads select the Create codespace button.

NOTE: You can use 60 hours of GitHub Codespaces for free each month.

If you'd prefer, you can clone the repo and run locally:

git clone https://github.com/microsoft/copilotadventures

Pre-Reqs: Basic programming language knowledge is helpful.

If you're new to GitHub Copilot, need to install the extensions, and want to learn how to get started using it, start with the Warmup Adventure.

Once you've completed the warmup adventure and have the extensions installed, choose another GitHub Copilot adventure from the list below:

• The Clockwork Town of Tempora
• The Magical Forest of Algora

• The Celestia Alignment of Lumoria
• The Legendary Duel of Stonevale
• The Scrolls of Eldoria

• The Gridlock Arena of Mythos

Read Your Copilot Adventure description, the high-Level tasks to perform, and the GitHub Copilot hints to help you write your code.

• Use GitHub Copilot and/or GitHub Copilot Chat to help you write the code for the adventure. You can use any language you'd like. Try learning a new language if you're up for the challenge (more on that below)!
• Leave any comments in your code to explain your thought process and show prompts that GitHub Copilot used to help you out.

If you'd like to share your solution with others, perform the following steps:

• Publish your adventure solution to a GitHub repo.

• Visit https://github.com/microsoft/CopilotAdventures/issues and select New Issue.

• Use the following naming convention for the issue title.

  Solution for [Name of Your Adventure]
  

  Replace [Name of Your Adventure] with the adventure name you chose to solve (example: The Legendary Duel of Stonevale).

• Add a link to your GitHub repo in the body section.

• If you have any feedback, share what you found (good or bad). We'd love to hear your feedback!

Once you've completed your first adventure, try it again but this time use GitHub Copilot to complete the adventure using a language that's new to you. For example, if you normally write code in C#, use Copilot to help you solve the adventure using Python or another language you'd like to learn more about.

Try creating a UI for your adventure. Use pure HTML/CSS/JavaScript or a library/framework of your choosing. Let GitHub Copilot/Chat help you out with the UI code. If your UI requires images, consider using Bing Image Creator or another AI image generation service.

Do you have a copilot adventure story/puzzle you'd like to submit for others to go through? We'd love to see it! Please submit a pull request to this repository with your adventure and solution.

• Use New Copilot Adventure: [Your Adventure Name] for the PR title. Replace [Your Adventure Name] with the name of your adventure.
• Include if your adventure is at the beginner, intermediate, or advanced level.
• Follow the markdown template used with each adventure in the Adventures folder as you create your adventure.
• Provide an image for your adventure (use Bing Image Creator or another image generator solution).
• Provide a solution using your chosen language. Place all of the code in a single file (to keep things simple) and include it in the PR.

We'll review your submission and merge it into the repo if it meets the criteria.

1. Sign in to GitHub.

2. Go to https://github.com/redeem/XXX-YYY where XXX-YYY is the coupon code for your workshop.

   

3. Fill in your address. It will not ask for a Credit Card.

4. Select Save.

5. In the coupon summary page, select Redeem.

   

6. You should receive a message on your GitHub dashboard.

   

7. Visit https://gh.io/copilot-free. This step is necessary after redeeming the coupon. You will not have access to GitHub Copilot until you've signed up and configured your preferences.

8. Select Get access to GitHub Copilot.

   

9. Pick the settings needed for the workshop (for example select Allow) and then select Save and get started.

   

10. You should now have access to GitHub Copilot for 7 days!