The repository is an early version of a simple way to participate in Advent of Code in a TypeScript environment. In this iteration, it'll also serve as my own puzzle solving repo. Let's go!

To get started, clone the repository and run npm ci in the root.

Any year folder in /src (like 2023, 2022 etc), are puzzle content and not part of the template.

First thing you need is your session token from adventofcode.com. This is used to fetch your personalized input data from each puzzle. It can be found under the network tab in your dev tools. Check this post for assistanse.

Once you have your token, copy .env.sample, rename it to .env, and include your token in the AOC_SESSION spot. In your .env file you can also adjust what year of Advent of Code you want to work with. Defaults to 2023.

Use npm run generate to generate a folder for a puzzle, and fetch the input data. The script expects an argument for the day you want to work with, for example npm run generate day=5 will generate the folder and fetch the input data for day 5.

The generated folder includes the following files:

• input.txt: The raw input data for the puzzle.
• index.ts: The TS file to work with, lightly prepared for reading the input file.
• 1.ts and 2.ts: The TS files for each part of the puzzle, lightly prepared for consuming the prepared input file.

From there, you're on your own. Navigate in to the day folder you want to work in, and run the script with npx nodemon index.ts. Good luck with the puzzles!