spritekit-game

SpriteKit 2D Game Development

This skill is for 2D games only. For 3D games (racing, bowling, board games, marble maze, tower defense, 3D sports), load the scenekit-game skill instead.

ARCHITECTURE OVERRIDE: 2D games use SpriteKit (SKScene + SpriteView), NOT plain SwiftUI views with timers or Canvas. The standard @main App → RootView → MainView pattern still applies, but MainView hosts a SpriteView instead of standard SwiftUI content. AppTheme rules apply to SwiftUI parts (menus, overlays) but NOT to SpriteKit scene internals where you use SKColor, SKLabelNode fonts, etc. directly.

Also load the game-assets skill for downloading sprites and textures via nw_download_asset.

SpriteView — SwiftUI Bridge

import SpriteKit
import SwiftUI

struct GameView: View {
    @State var gameState = GameState()

    var body: some View {
        ZStack {
            SpriteView(scene: makeScene(), isPaused: gameState.isPaused)
                .ignoresSafeArea()

            // SwiftUI overlays for HUD, menus (use AppTheme here)
            if gameState.isPaused {
                PauseMenuView(gameState: gameState)
            }
        }
    }

    private func makeScene() -> GameScene {
        let scene = GameScene(size: UIScreen.main.bounds.size)
        scene.scaleMode = .resizeFill
        scene.gameState = gameState
        return scene
    }
}

Rules:

• Use .scaleMode = .resizeFill so the scene adapts to actual view size
• Pass data between SwiftUI and SpriteKit via @Observable game state objects
• SwiftUI overlays (menus, HUD, pause) sit in a ZStack above SpriteView
• Use SpriteView(scene:, isPaused:) to control pause from SwiftUI
• SwiftUI parts use AppTheme. SpriteKit scene internals use SKColor/SKLabelNode directly.

Scene Architecture

Layer-based node hierarchy — create in didMove(to:):

SKScene (GameScene)
├── backgroundLayer (SKNode) — z: -100
├── gameplayLayer (SKNode)  — z: 0
└── hudLayer (SKNode)       — z: 100