Prepare release v0.1.0

.github/workflows/release.yml

@@ -0,0 +1,63 @@
+name: Build and Release
+
+on:
+  push:
+    tags:
+      - 'v*'  # Triggers on version tags like v0.2.0, v0.3.0, etc.
+  workflow_dispatch:  # Allows manual trigger from GitHub UI
+
+jobs:
+  build-and-release:
+    runs-on: macos-14  # macOS 14 (Sonoma) with Apple Silicon support
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Swift
+        uses: swift-actions/setup-swift@v2
+        with:
+          swift-version: "5.10"
+
+      - name: Extract version from tag
+        id: get_version
+        run: |
+          if [[ "${{ github.ref }}" == refs/tags/* ]]; then
+            VERSION=${GITHUB_REF#refs/tags/v}
+          else
+            VERSION="0.2.0-dev"
+          fi
+          echo "VERSION=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Build app bundle
+        run: |
+          chmod +x ./create_app_bundle.sh
+          # Update version in script
+          sed -i '' "s/VERSION=\".*\"/VERSION=\"${{ steps.get_version.outputs.VERSION }}\"/" create_app_bundle.sh
+          ./create_app_bundle.sh
+
+      - name: Create DMG
+        run: |
+          chmod +x ./create_dmg.sh
+          # Update version in script
+          sed -i '' "s/VERSION=\".*\"/VERSION=\"${{ steps.get_version.outputs.VERSION }}\"/" create_dmg.sh
+          ./create_dmg.sh
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v1
+        if: startsWith(github.ref, 'refs/tags/')
+        with:
+          files: |
+            UntoldEngineStudio-${{ steps.get_version.outputs.VERSION }}.dmg
+          draft: false
+          prerelease: false
+          generate_release_notes: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Upload DMG artifact (for manual builds)
+        if: github.event_name == 'workflow_dispatch'
+        uses: actions/upload-artifact@v4
+        with:
+          name: UntoldEngineStudio-${{ steps.get_version.outputs.VERSION }}
+          path: UntoldEngineStudio-${{ steps.get_version.outputs.VERSION }}.dmg

.gitignore

@@ -47,6 +47,7 @@ DerivedData/
 *.exe
 *.out
 *.app
+*.dmg
 *.ipa
 
 # ---------------------------------------

Package.swift

@@ -13,7 +13,7 @@ let package = Package(
         // Use a branch during active development:
         // .package(url: "https://github.com/untoldengine/UntoldEngine.git", branch: "develop"),
         // Or pin to a release:
-        .package(url: "https://github.com/untoldengine/UntoldEngine.git", exact: "0.6.0"),
+        .package(url: "https://github.com/untoldengine/UntoldEngine.git", exact: "0.6.1"),
     ],
     targets: [
         .executableTarget(

README.md

@@ -1,13 +1,52 @@
 # Untold Editor
 
-The **Untold Editor** is a companion tool for the [Untold Engine](https://github.com/untoldengine/UntoldEngine).  
-It provides a visual environment for managing assets, scenes, and entities in projects built with the engine.  
+The **Untold Editor** is the visual development environment for the [Untold Engine](https://github.com/untoldengine/UntoldEngine).  
+It provides a complete toolkit for building games with scripting support, asset management, scene editing, and more.
 
-The editor is not required to use the engine, but it makes iteration faster by giving developers and designers a user-friendly interface.
+## 🎮 For Game Developers
+
+**Want to make games? Download [Untold Engine Studio](https://github.com/untoldengine/UntoldEditor/releases)** — a standalone app that includes everything you need:
+
+- ✅ Complete visual editor
+- ✅ Scripting system for game logic
+- ✅ All engine features built-in
+- ✅ No setup required — just download the DMG and start creating
+
+👉 **[Download Untold Engine Studio](https://github.com/untoldengine/UntoldEditor/releases)**
+
+## 🛠️ For Contributors
+
+This repository is for developers who want to **contribute to the editor itself**. If you're looking to improve the editor, fix bugs, or add features, you're in the right place!
 
 ![UntoldEditorScreenshot](images/editorscreenshot.png)
 ---
 
+## 📚 Understanding the Ecosystem
+
+The Untold Engine project has three main components:
+
+### For Game Developers:
+- **[Untold Engine Studio](https://github.com/untoldengine/UntoldEditor/releases)** (Download)
+  - Standalone app with everything included
+  - Scripting, visual editor, asset management
+  - No GitHub or build tools required
+  - **Start here if you want to make games**
+
+### For Engine/Editor Contributors:
+- **[Untold Engine](https://github.com/untoldengine/UntoldEngine)** (Clone to contribute)
+  - Core engine repository
+  - Rendering, physics, ECS, animation systems
+  - Clone this if you want to contribute to the engine core
+
+- **[Untold Editor](https://github.com/untoldengine/UntoldEditor)** (This repo)
+  - Editor interface and tooling
+  - Clone this if you want to contribute to the editor
+
+### Additional Resources:
+- **Examples / Starter Projects:** [UntoldEngineExamples](https://github.com/untoldengine/UntoldEngineExamples)
+
+---
+
 ## ✨ Features
 
 - **Scene Graph** – Organize and visualize entity hierarchies  
@@ -27,9 +66,11 @@ The editor is not required to use the engine, but it makes iteration faster by g
 
 ---
 
-## 📦 Getting the Editor
+## 📦 Development Setup
+
+**Note:** If you just want to make games, download [Untold Engine Studio](https://github.com/untoldengine/UntoldEditor/releases) instead.
 
-Clone this repository:
+For editor development, clone this repository:
 
 ```bash
 git clone https://github.com/untoldengine/UntoldEditor.git
@@ -115,13 +156,6 @@ See **CONTRIBUTING.md** and **CODE_OF_CONDUCT.md** (coming soon).
 
 ---
 
-## 📚 Related Repos
-
-- **Engine Core:** [Untold Engine](https://github.com/untoldengine/UntoldEngine)  
-- **Examples / Starter Projects:** [UntoldEngineExamples](https://github.com/untoldengine/UntoldEngineExamples)  
-
----
-
 ## 📜 License
 
 Licensed under **GNU LGPL v3.0**.  

Sources/UntoldEditor/Build/BuildSettingsView.swift

@@ -25,6 +25,7 @@ struct BuildSettingsView: View {
     @State private var showBuildResult: Bool = false
     @State private var buildResultMessage: String = ""
     @State private var buildSucceeded: Bool = false
+    @State private var showBasePathAlert: Bool = false
 
     @Environment(\.dismiss) private var dismiss
 
@@ -122,6 +123,7 @@ struct BuildSettingsView: View {
             HStack {
                 Spacer()
                 Button("Build") {
+                    guard ensureAssetBasePath() else { return }
                     startBuild()
                 }
                 .buttonStyle(.borderedProminent)
@@ -146,6 +148,11 @@ struct BuildSettingsView: View {
         } message: {
             Text(buildResultMessage)
         }
+        .alert("Set Asset Folder First", isPresented: $showBasePathAlert) {
+            Button("OK", role: .cancel) {}
+        } message: {
+            Text("Please set the Asset Folder in the Asset Browser before building.")
+        }
         .onAppear {
             loadDefaultSettings()
         }
@@ -260,6 +267,14 @@ struct BuildSettingsView: View {
 
         NSWorkspace.shared.open(xcodeProjectPath)
     }
+
+    private func ensureAssetBasePath() -> Bool {
+        guard EditorAssetBasePath.shared.basePath != nil else {
+            showBasePathAlert = true
+            return false
+        }
+        return true
+    }
 }
 
 #Preview {