Spotify Story Teller Development Guide

This skill provides guidance for working with the Spotify Story Teller iOS application codebase. It includes build commands, code style guidelines, and best practices for SwiftUI development.

When to Use This Skill

Use this skill when:

Build and Test Commands

When building or testing the application:

1. **Build the project**: Open in Xcode and use Product > Build (⌘B)

2. **Run the app**: Use Product > Run (⌘R)

3. **Run all tests**: Use Product > Test (⌘U)

4. **Run single test**: Click the test diamond icon in the Xcode test file gutter

Code Style Guidelines

Imports

```swift

import Foundation

import SwiftUI

import Combine

```

Formatting

Type Annotations

```swift

public let username: String // explicit for public API

let count = 0 // inferred

```

Naming Conventions

Error Handling

SwiftUI Best Practices

- `@State` for local view state

- `@EnvironmentObject` for shared app state

- `@Binding` for two-way data flow

Asynchronous Code

Comments

Environment and Configuration

Key Files and Structure

When working with the codebase:

Examples

Proper Import Ordering

```swift

import Foundation

import SwiftUI

import Combine

import SpotifyAPI

```

Property Wrapper Usage

```swift

struct ContentView: View {

@State private var isLoading = false

@EnvironmentObject var appState: AppState

@Binding var selectedItem: Item?

}

```

Error Handling

```swift

do {

let data = try await fetchData()

processData(data)

} catch {

print("Failed to fetch data: \(error.localizedDescription)")

showErrorAlert = true

}

```