Download the PHP package drlopes/template-sync without Composer

Template Sync

A Laravel package that keeps your project in sync with the template repository it was created from. Run one command to pull in the latest changes from your template — conflicts are caught, local overrides are preserved, and a backup branch is created before every sync.

Installation

Publish the config file:

Usage

1. Connect to your template

Run the interactive setup command once. It prompts for your template repository URL and preferences, writes config/template-sync.php, and adds the git remote:

You will be asked for:

• Template repository URL — the GitHub/GitLab URL of the template repo
• Remote name — the git remote name to use (default: template)
• Branch — which branch on the template to merge from (default: main)
• Allow unrelated histories — pass --allow-unrelated-histories to git merge; needed when the repo was created from a GitHub template
• Auto-delete backup branch — whether to remove the backup branch after a successful sync
• Excluded paths — files to keep at your local version even when the template changes them

2. Sync template changes

Pull in the latest changes from the template at any time:

The command will:

1. Add the template remote if it is missing
2. Create a backup branch (e.g. backup/before-template-update-2025-05-16) so you have a restore point
3. Fetch and merge the template branch
4. If the merge conflicts, pause with the merge in progress so you can resolve the conflicts yourself (see below)
5. If the merge succeeds, restore any excluded paths to their local versions, then commit

Resolving conflicts

When the merge runs into conflicts, the command stops and leaves the repository in a mid-merge state — your working tree contains the conflict markers, just like a normal git merge. You then have two options:

Finish the sync — fix the conflicts in your editor, stage the resolved files, and continue:

--continue re-applies your excluded paths, creates the sync commit, and cleans up the backup branch if delete_on_success is enabled.

Abort the sync — discard the merge and return to where you were:

--abort runs git merge --abort and leaves the backup branch in place so you can still inspect it.

While a sync is paused, re-running php artisan template:update without a flag will refuse to start a new sync and remind you to use --continue or --abort.

Configuration

Excluded paths

Use excluded_paths for files your project has customised and should never receive template updates. After every successful merge, those files are restored to your local version before the commit is made, so template changes to them are silently dropped.

Backup branch

Before every sync, a branch named {prefix}-{date} (e.g. backup/before-template-update-2025-05-16) is created at your current HEAD as a safety net. It is preserved whenever the sync pauses on conflicts or is aborted, so you can always git checkout it to get back to your previous state. Set delete_on_success to false to keep it even after a clean sync.

Testing

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Daniel Lopes
• All Contributors

License

The MIT License (MIT). Please see License File for more information.