🎄 AdventOfCode-typescript-template 🎄

This is a TypeScript boilerplate for Advent of Code.

built with ❤️ and:

• Node.js 24 🟢
• Typescript 👨‍💻
• Bun 🧅

👷‍♂️ Project structure

the project has the following structure:

src
- days: contains the solutions for the puzzles
- scripts: utility scripts for development lifecycle
- types: types and interfaces
- utils: utility scripts used for development and problem solving (i.e read an input file)

🚀 Getting started

This readme assumes you are using pnpm as package manager, but any other package manager will do.

This project is fully built in Typescript, you can run the code either with Node.js runtime or with bun, check the docs for installing it.

install all required dependencies with pnpm i

🎄 Adding a new puzzle

when the new AoC puzzle is available run pnpm init-day {day}

replace {day} with the number of the advent day, i.e. pnpm init-day 2.

This command will create a new directory in the days folder with the following content

• Puzzle.ts: the boilerplate module with the placeholder methods for solving both daily puzzles
• index.txt: the input file where to add the puzzle input

The structure of the boilerplate module is the following:

const first = (input: string) => {
  console.log(input);
  return 'solution 1';
};

const expectedFirstSolution = 'solution 1';

const second = (input: string) => {
  console.log(input);
  return 'solution 2';
};

const expectedSecondSolution = 'solution 2';

export { first, expectedFirstSolution, second, expectedSecondSolution };

🔧 Development

When your solution is ready, or when you want to start developing incrementally (watch mode) run pnpm start:dev {day} where {day} is the day you are working on, i.e. pnpm start:dev 1 will run the puzzle class for day 1.

🧪 Testing

You can run test for all puzzles agains their expected output with pnpm t this will test all the solutions in the days folder

🧅 Using Bun

dev, test and start script have their :bun counterpart as in start:bun to use bun instead of node

🛫 Contributing

Every contribution is welcome. Just fork this repo and open a MR with your changes, and don't forget to add your name to the contributors section of this README.

👨👩 Contributors

Francesco Maida

Devin Spikowski

Nitish Thiyagarajan

Abdul Isik