PHPackages                             mjderoode/advent\_of\_code\_helper - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. mjderoode/advent\_of\_code\_helper

ActiveLibrary[Utility & Helpers](/categories/utility)

mjderoode/advent\_of\_code\_helper
==================================

Laravel package to make the advent of code a bit more "manageable"

v2.0(7mo ago)012MITPHPPHP ^8.3

Since Oct 6Pushed 7mo ago1 watchersCompare

[ Source](https://github.com/mjderoode/advent_of_code_helper)[ Packagist](https://packagist.org/packages/mjderoode/advent_of_code_helper)[ RSS](/packages/mjderoode-advent-of-code-helper/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (2)Versions (10)Used By (0)

Advent of Code Helper, Laravel Package
======================================

[](#advent-of-code-helper-laravel-package)

Every year, I run into the same issues and start “hacking and cracking” as soon as Advent of Code begins. Not anymore! I wrote this Laravel package with two clear goals: to download your personal puzzle inputs and to prepare controller files so you don’t have to start hacking in your web.php.

This Laravel package can download all of your personal puzzle inputs for a specific year and, afterward, it prepares a default controller split into two parts, allowing you to solve each part of the daily Advent of Code challenges. I also prepared some options on how to view your solution.

**My Laravel package is currently in a “WIP” (Work in Progress) phase, so please keep this in mind when using it.**

Get your Session Cookie
-----------------------

[](#get-your-session-cookie)

```
1.   Log in to the Advent of Code website: https://adventofcode.com
2.   Open the developer console in your browser and navigate to the Cookies section
2.5  - For Chromium-based browsers, go to Application → Storage → Cookies, then click on the Advent of Code website URL.
3.   Look for the "session" cookie, and copy its value
4.   Add the following key to your .env file: ADVENT_OF_CODE_SESSION_COOKIE, and paste your session cookie value here.

```

Installation
------------

[](#installation)

Install `mjderoode/advent_of_code_helper` with composer:

```
composer require mjderoode/advent_of_code_helper
```

Add your session cookie value to the .env:

```
ADVENT_OF_CODE_SESSION_COOKIE="################################"
```

Optionally, you can disable routing by setting the following key in your .env file (must be a boolean; the default is true):

```
ADVENT_OF_CODE_ROUTING_ENABLED=false
```

Usage/ Examples
---------------

[](#usage-examples)

The Laravel package includes two commands: `aoc:import` and `aoc:try`.

The `aoc:import` command is used to download your personal puzzle inputs and prepare the necessary Controller files. This command expects two parameters: the first (year) is mandatory with a default value of 2024, and the second (day) is optional.

To download all of your puzzle inputs from 2023, run:

```
php artisan aoc:import 2023
```

By specifying the second argument, you can download the puzzle input for a specific day, for example day 3 of 2016.

```
php artisan aoc:import 2016 3
```

The `aoc:try` command is used to test your solutions. This command expects three parameters: year, day, and part (with defaults: year=2024 and part=1).

```
php artisan aoc:try 2023 1 1
```

Publishable assets
------------------

[](#publishable-assets)

Don’t like the stub? No problem! Just run the following command, and the stub will be published, ready for you to edit as you like!

```
php artisan vendor:publish --tag="stubs-aoc"
```

Try out your solutions
----------------------

[](#try-out-your-solutions)

In this Laravel package, you have several options to try out your solutions. The first is through the command line—refer to the `aoc:try` command as explained in the previous section.

The second option is to view your solution in the browser. I’ve prepared a specific route for your Advent of Code controllers (see `php artisan route:list`, specifically `aoc.solution`). For example, to view your solution for “year 2016, day 2, part 2,” go to `{{ YOUR APP URL HERE }}/2016/2/2`.

TODO's
------

[](#todos)

#### Tasks

[](#tasks)

- Refactor code; this one never ends.
- Detach the “GenerateControllerLayoutJob”.
- Make “GenerateControllerLayoutJob” available in its own command.
- Download all puzzle inputs from the start to the current year? (Not sure yet).

Authors
-------

[](#authors)

- [@mjderoode (github)](https://github.com/mjderoode)

License
-------

[](#license)

The MIT License ([MIT](https://choosealicense.com/licenses/mit/)).

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance64

Regular maintenance activity

Popularity5

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~60 days

Recently: every ~104 days

Total

8

Last Release

216d ago

Major Versions

v1.0.6 → v2.02025-11-30

PHP version history (2 changes)v1.0.0PHP ^8.2

v2.0PHP ^8.3

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/4389321?v=4)[Mitchell de Roode](/maintainers/mjderoode)[@mjderoode](https://github.com/mjderoode)

---

Top Contributors

[![mjderoode](https://avatars.githubusercontent.com/u/4389321?v=4)](https://github.com/mjderoode "mjderoode (11 commits)")

---

Tags

laravel-packageaocadvent of codeaoc helperadvent of code helper

### Embed Badge

![Health badge](/badges/mjderoode-advent-of-code-helper/health.svg)

```
[![Health](https://phpackages.com/badges/mjderoode-advent-of-code-helper/health.svg)](https://phpackages.com/packages/mjderoode-advent-of-code-helper)
```

###  Alternatives

[craftcms/cms

Craft CMS

3.6k3.6M3.1k](/packages/craftcms-cms)[spatie/laravel-export

Create a static site bundle from a Laravel app

674146.0k6](/packages/spatie-laravel-export)[nativephp/mobile

NativePHP for Mobile

1.1k75.1k91](/packages/nativephp-mobile)[venturedrake/laravel-crm

A free open source CRM built as a package for laravel projects

43311.2k](/packages/venturedrake-laravel-crm)[flarum/core

Delightfully simple forum software.

201.4M2.3k](/packages/flarum-core)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)