While Hyde is in beta, stuff can change rapidly.#
This guide will help you update Hyde to the latest version. It is recommended to back up your source files before updating.
Updating Hyde/Framework#
Run the following command from your Hyde/Hyde installation:
1composer update hyde/framework
Next, follow the post-update instructions for Hyde/Hyde.
Updating Hyde/Hyde#
When updating an existing installation, first ensure you have a Git backup of your source files to revert the update.
Depending on how you installed Hyde, there are a few different ways to update it.
Using Git#
Make sure you have a remote set up for the repository.
1git remote add upstream https://github.com/hydephp/hyde.git
Then pull the latest changes from the remote:
1git pull upstream master
After this, you should update your composer dependencies:
1composer update
Next, follow the post-update instructions for Hyde/Hyde.
Manual Update#
Since all resource files are in the content directories you can simply copy those files to the new location.
If you have changed any other files, for example in the App directory, you will need to update those files manually as well. But if you have done that you probably know what you are doing. I hope. The same goes if you have created any custom blade components or have modified Hyde ones.
Example CLI workflow, assuming the Hyde/Hyde project is stored as my-project
in the home directory:
1cd ~2mv my-project my-project-old3composer create-project hyde/hyde my-project4 5cp -r my-old-project/_pages my-project/content/_pages6cp -r my-old-project/_posts my-project/content/_posts7cp -r my-old-project/_media my-project/content/_media8cp -r my-old-project/_docs my-project/content/_docs9cp -r my-old-project/config my-project/config
Next, follow the post-update instructions for Hyde/Hyde. After verifying that everything is working, you can delete the old project directory.
Post-update instructions#
After updating Hyde you should update your config and resource files. This is where things can get a tiny bit dangerous as the files will be overwritten. However, since you should be using Git, you can take care of any merge conflicts that arise.
1php hyde update:configs2php hyde update:assets
If you have published any of the Hyde Blade components you will need to re-publish them.
1php hyde publish:views layouts2php hyde publish:views components
Next, re-build your site.
1php hyde build
And recompile your assets if applicable.
1npm install2npm run dev/prod