Skip to content

[2.x] Add upgrade guide #2319

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
emmadesilva merged 12 commits into from
Oct 1, 2025
Merged

[2.x] Add upgrade guide #2319

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
0a5fe4c
Add upgrade guide
emmadesilva Sep 30, 2025
18b211b
Merge branch 'master' into feat/upgrade-guide
emmadesilva Oct 1, 2025
5268549
Document moved config key
emmadesilva Oct 1, 2025
0b72aae
Go through upgrade guide one more time
emmadesilva Oct 1, 2025
4c83509
Proofreading
emmadesilva Oct 1, 2025
d078a35
Remove overkill information
emmadesilva Oct 1, 2025
8f6efa7
Final proofreading
emmadesilva Oct 1, 2025
ad99b00
Sync upgrade guide
emmadesilva Oct 1, 2025
6cf6240
Clarify section
emmadesilva Oct 1, 2025
9c9a468
Update to document default value
emmadesilva Oct 1, 2025
7b5faac
Final upgrade guide proofreading
emmadesilva Oct 1, 2025
61c2926
Final release notes proofreading
emmadesilva Oct 1, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions RELEASE_NOTES.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,14 +4,16 @@

HydePHP v2.0 represents a major evolution of the framework, introducing significant improvements to the asset system, navigation API, and overall developer experience. This release modernizes the frontend tooling by replacing Laravel Mix with Vite, completely rewrites the navigation system for better flexibility, and introduces numerous performance optimizations throughout the framework.

This document will give you an overview of the changes. When you're ready to upgrade your site, take a look at the [Upgrade Guide](https://hydephp.com/docs/2.x/upgrade-guide).

## Major Features

### 🚀 Modern Frontend Tooling with Vite

We've replaced Laravel Mix with Vite for a faster, more modern development experience:
- **Instant Hot Module Replacement (HMR)** for real-time updates during development
- **Direct asset compilation** into the `_media` folder for cleaner builds
- **Updated build command**: Use `npm run build` instead of `npm run prod` (or `--vite` during the sit build)
- **Updated build command**: Use `npm run build` instead of `npm run prod` (or `--vite` during the site build)
- **Vite facade** for seamless Blade template integration
- **Optimized asset serving** through the realtime compiler
- **Hyde Vite plugin** for enhanced integration
Expand Down Expand Up @@ -170,7 +172,7 @@ Key changes:
- A new `Hyde::authors()` method provides access to all site authors
- Authors can be configured via YAML

The way this system now works is that you first define authors in the config, Hyde the loads this during the booting process, and you can then access them using the get method.
The way this system now works is that you first define authors in the config, Hyde then loads this during the booting process, and you can then access them using the get method.

### Medium Impact Changes

Expand Down Expand Up @@ -294,7 +296,7 @@ Documentation sidebar configuration has been reorganized:

## Removed Features

### Deprecated Methods
### Deprecated Method Removals
- `PostAuthor::getName()` - use `$author->name` property
- `FeaturedImage::isRemote()` - use `Hyperlinks::isRemote()`
- `DocumentationPage::getTableOfContents()` - use Blade component
Expand Down
Loading
Loading