Creating Versions

DevOur uses semantic versioning to help you track and manage different states of your project. Each version captures a snapshot of your project settings, products, colors, and locales.

Prerequisites

Before creating versions, ensure you have:

1. An existing project in DevOur
2. Configured at least basic project settings

Understanding Semantic Versioning

DevOur uses Semantic Versioning format: MAJOR.MINOR.PATCH

• MAJOR: Breaking changes (e.g., 2.0.0)
• MINOR: New features, backward compatible (e.g., 1.1.0)
• PATCH: Bug fixes, backward compatible (e.g., 1.0.1)

Optional suffixes are supported: 1.0.0-alpha, 1.0.0-beta.1

Create a New Version

1. Open your project in DevOur
2. Navigate to the project page
3. Enter a version number in the version input field (e.g., 1.0.0)
4. Click Create

A new version record is created with your current project settings. You can then create a bundle for download.

DevOur allows a maximum of 5 versions per project. If you've reached this limit, delete an existing version before creating a new one.

Auto-Increment Version

Enable automatic version incrementing to have DevOur automatically create new versions when you make changes to your project.

Enable Auto-Increment

1. Open your project in DevOur
2. Toggle Auto-increment version to on

How Auto-Increment Works

When enabled:

• Any change to project settings, products, colors, or locales triggers a new version
• Only the PATCH number increments automatically (e.g., 1.0.0 → 1.0.1)
• Changes to the version field itself do not trigger auto-increment
• Toggling auto-increment on/off does not trigger a new version

When to Use Auto-Increment

Recommended for:

• Active development with frequent changes
• When you want a complete history of all modifications
• Projects where you may need to revert to any previous state

Not recommended for:

• Projects with infrequent changes
• When you prefer manual control over version numbers

Warning: With the 5 version limit, auto-increment can quickly fill your version slots. Delete old versions regularly to avoid reaching the limit.

Version History

All created versions appear in the Versions list below the version input. Each version shows:

• Version number
• Bundle status (pending, created, or error)

Download a Version Bundle

1. Locate the version in the list
2. If bundle status is Created, click Download
3. If bundle is pending, click Create Bundle first, then download

Delete a Version

1. Click the delete icon next to the version
2. Confirm deletion

Deleting a version removes both the version record and its associated bundle file.

Reset to a Previous Version

If you need to restore your project to a previous state, use the reset feature.

Perform a Reset

1. Find the target version in the Versions list
2. Click the reset icon next to that version
3. Read the warning carefully
4. Click Confirm to proceed

Important Warnings

• Save before resetting: If your current project state is not saved as a version, those changes will be lost permanently
• Reset restores all project settings, products, colors, and locales to their state at that version
• The reset cannot be undone unless you have a version of your current state

Best Practices

1. Always create a version of your current state before resetting
2. Use descriptive version numbers to remember what each version contains
3. Test the restored version to ensure it meets your needs

Version Limits

DevOur allows up to 5 versions per project. When you reach this limit:

1. A modal appears asking you to delete existing versions
2. Select which versions to remove
3. Confirm deletion to proceed with creating your new version

Related Documentation

• Downloading and Running Your Project
• Quick Start
• Creating Products