I thought I'd take a stab at creating a dark mode version of the docs:

Updated syntax highlighting under dark mode:

Updated footer:

The initial color setting is based on prefers-color-scheme. You can toggle between light and dark with the button on the header:

The mobile version:

For the time being, dark mode has only been implemented on pages under /docs/*, the rest of the website should still be unchanged and only have light mode. This is my first open-source contribution, so any and all feedback would be definitely appreciated.

I'm Alex, CTO at Ukrainian-based company Cargofy.

My country is going through hard times now, I am forced to work from bomb shelter, and millions of people were forced to change their place of residence to escape the war. Now we need the efforts of the whole world to stop the war and support Ukraine in its defense.

I use Laravel in my daily work, and I propose to place a banner supporting Ukraine on laravel.com, and thereby join the thousands of companies around the world who are already helping.

I rarely ask for help, but now is the moment when every action can help us survive. Stand with Ukraine 🇺🇦

This PR adds a copy button so people can easily copy a snippet. The original code comes from @nunomaduro and the Pest documentation.

When copied it looks like this:

When code goes underneath the button there's a bit of overlap (intentionally):

When the scrolling takes place, the copy button scrolls with the content:

Unfortunately I do not know how to solve this. I think it's a very minor thing overall and it probably won't significantly hinder someone.

Ref: https://github.com/code-lts/doctum/issues/2 (discussion with the author of Sami)

Changes in this PR:

• Replace Sami by Doctum
• Allow base in scripts to be overridden base="$(pwd)/../" ./api.sh
• Update lock file
• Update config

This PR adds a link in the header to the Laravel Big Cartel Shop.

A side effect of adding the extra link was an overlap of the Search bar. This required a change in the width of the Search bar by 1% (see new layout image below)

My reason behind this PR was due to me looking for the shop to purchase some gear and I resorted to searching twitter for it.

Currently, in the 'Ecosystem' dropdown and when you click on the one for Horizon it goes to horizon.laravel.com which just redirects to the laravel.com homepage.

I've updated this so that it now links to Horizon's documentation page.

This feature adds a collapse/expand link to the sidebar nav by utilizing browser local storage. This code piggybacks off of the old documentation's javascript, with a couple of minor tweaks.

Adds cell highlighting to the bug fixes and security fixes columns of the support policy table.

If the support date has expired the cell is red.

If the support date is within 90 days of expiring the cell is orange (the 90 days could be changed in doc.js).

I left supported versions white as I felt the table looked cleaner than having lots of green cells.

This works in all versions of the docs that have a support policy table 5.6+.

It also works in dark mode.

Follow-up to #153 (and the subsequent #154).

On browser Pale Moon, the code tags are shifted up, which makes reading the documentation quite tedious. That seems to be because Pale Moon applies a different default baseline, closer to the specifications, than Firefox and Chrome.

For more details you may read this topic on Pale Moon forum.

Removes index.php from the URL's (see https://github.com/laravel/framework/issues/30398 for more information about why this happens)

Fix from @mattiasgeniar: https://github.com/laravel/framework/issues/30398#issuecomment-556310025

This fixes a visual bug in Firefox Dev Edition (70.0b2 64-bit) on macOS.

The same line height in Chrome appears fine as well. There was a bit of overflow in FF and the last item in a sidebar list was cut off.

This PR adds custom "open graph" meta tags and images for each docs page. By default it relies on the page title and the first sizable code block on the page, but I've added support for customization that can come later (thru separate PRs directly to the docs repo).

I extracted out a Page class to encapsulate some of the logic, and had to tweak the layout a bit to allow for overriding the metadata.

Here's a side-by-side comparison. Note that not only is the image preview different, but the text below the image is different as well.

Should this PR get merged, additional customizations can be applied by adding frontmatter data to the individual docs page.

For example, the default open graph data for the installation page in the docs will show a code block from the “Database and Migration” section, since that's the first code on the page that's larger than a line or two. It's possible to add a custom code block to the installation.md file that will be used when generating the open graph image. It's also possible to add a custom title, if it makes sense to add something more specific for the image and social cards.

Changelog

Changed

• Upgrade PHP from 7.4 to 8.1 (makes the upgrade to Laravel 10 easier)
• Upgrade laravel/framework from ^8.0 to 9.30 (and necessary update steps)
• Switch from facade/ignition to spatie/laravel-ignition
• Upgrade other dependencies to latest version

Removed

• Removed yarn.lock because package-lock.json exists
• Removed server.php (not needed anymore for Laravel 9)
• Removed symfony/browser-kit (not used anywhere as far as I have seen)

Additional Notes

Switch from Mix to Vite will be done in another PR, after this one was accepted.