Syncing Updates in StartupBolt

Many of our customers have asked about the best way to sync updates to their existing projects. We've developed a systematic approach and best practices to handle this efficiently.

StartupBolt comes with a .git folder containing git history, giving you two options for updates (From Dec 16, 2024).

First-Time Users

The process is straightforward for new users:

1. Download the latest zip file
2. Unzip it to your desired location
3. Follow the instructions in our Quick Start guide

Existing Project Updates

If you already have a project and want to upgrade to the latest version of StartupBolt, follow these steps:

1. Download the latest zip and unzip it to a separate folder
2. In your existing project folder, run these commands:

git remote add upstream ../new-version
git fetch upstream
git merge upstream/master
git remote remove upstream

3. This process merges the new version into your existing project

Handling Conflicts

To minimize and handle conflicts effectively, we recommend following these best practices:

Module Management

• Use props whenever possible - StartupBolt modules accept props to change colors, texts, images, etc., without editing the code directly
• Avoid editing prebuilt modules in /modules/native and /modules/shadcn as we regularly improve these
• For custom modifications, copy modules to /modules/custom and edit them there - this directory won't face conflicts

Utility Functions

• Avoid editing core utilities in /utils
• Create new utilities in /utils/custom to prevent conflicts
• Remember that core utilities are essential for StartupBolt's functionality and may be updated in new releases

Page and Layout Files

• Most conflicts occur in root layout, root page, private layout, and private page files
• New pages you create won't typically face conflicts
• When conflicts arise, review the diffs carefully before merging
• Understanding git merge strategies will help resolve conflicts smoothly

Using Changelogs

For clarity during the merge process, refer to our version changelogs available in the dashboard next to the download button. These logs detail specific file and line changes to guide you through conflict resolution.

Conclusion

By following these guidelines and best practices, you can efficiently manage updates to your StartupBolt project while minimizing conflicts. The combination of proper module management, utility organization, and careful attention to core files ensures a smooth update process.