Documentation Index
Fetch the complete documentation index at: https://docs.swiftaiboilerplate.com/llms.txt
Use this file to discover all available pages before exploring further.
AI-Assisted Development
SwiftAI Boilerplate Pro ships with configurations for three AI coding tools: Claude Code, Cursor AI, and Bolt AI. Each one reads your project structure, follows your architecture, and generates code that fits. No setup required. Open the project and start building.Claude Code (CLAUDE.md)
The boilerplate includes a production-testedCLAUDE.md that gives Claude Code full project context from the first message. Claude reads it automatically when you open the project directory.
What CLAUDE.md Covers
- Architecture: MVVM patterns, module boundaries, which abstractions to use
- Build commands: Environment-aware instructions for Xcode MCP vs Claude Code CLI
- Anti-patterns: No UIKit, no ObservableObject, no raw URLSession
- File conventions: Naming patterns, organization, where new code belongs
- Integration specifics: Supabase, RevenueCat, OpenRouter configuration
How Agentic Development Works
- Open Claude Code in your project directory
- Describe the feature you want
- Claude reads your codebase, generates code following your patterns, builds it, and iterates until it works
Example Workflow
Community Skills
You can extend Claude’s iOS knowledge with community skills. These teach Claude about platform conventions, Xcode tooling, and SwiftUI best practices.Apple Skills
Apple platform conventions, Xcode project structure, App Store review awareness.
/install-skill https://github.com/mhanlon/apple-skillsiOS Simulator
Lets Claude boot, build, install, and interact with the iOS Simulator directly.
/install-skill https://github.com/nicholascallee/ios-simulator-claudecodeCursor AI Rules (.cursor/rules/)
Cursor AI reads .mdc (Markdown Code) files from your project to understand patterns and constraints. Four rule files are included.
Included Rule Files
core.mdc
Applied to: All Swift filesFile size limits (max 400 lines), MVVM patterns, dependency injection, error handling, Swift Concurrency, testing requirements.
swiftui-views.mdc
Applied to: View files (
*View.swift)View composition, state management, list optimization, navigation, form handling, accessibility.architecture.mdc
Applied to: Repositories, Clients, PackagesModular package boundaries, protocol-based APIs, repository pattern, CompositionRoot, structured logging, test doubles.
design-system.mdc
Applied to: DesignSystem, AppShellDSColors tokens, DSFonts/DSText typography, DSSpacing tokens, component library usage, theme consistency.
How It Works
Open the project in Cursor. The rules load automatically. Ask Cursor to build something, and it follows your architecture.Example Prompts
Creating Views
Creating Views
Creating ViewModels
Creating ViewModels
Creating Feature Packages
Creating Feature Packages
Refactoring
Refactoring
Bolt AI Chat Modes (.bolt/)
Bolt AI provides 12 specialized AI assistants for different development tasks. Each mode loads relevant context and uses a domain-specific system prompt.
Available Chat Modes
iOS Developer
/dev (default). General iOS/SwiftUI development with MVVM and async/await.Architecture
/arch. Package boundaries, protocol-based APIs, clean architecture.SwiftUI
/ui. View composition, DesignSystem usage, state management, accessibility.Feature Dev
/feature. Self-contained feature modules with protocol APIs and tests.Integration
/integration. Supabase, RevenueCat, Firebase setup and troubleshooting.Testing
/test. Unit tests, mock protocols, test doubles, async testing.Debug
/debug. Bug diagnosis, crash analysis, memory leaks, performance.Performance
/perf. Memory management, lazy loading, rendering optimization.Package Dev
/package. Swift Package Manager, API design, dependencies.Deploy
/deploy. App Store submission, TestFlight, provisioning, CI/CD.Accessibility
/a11y. VoiceOver, Dynamic Type, inclusive design, WCAG compliance.Documentation
/doc. Technical writing, API docs, integration guides.Before and After
Without configurations, AI generates code with hardcoded colors, no ViewModel, direct singleton dependencies, and no error handling. With configurations, the same prompt produces code that follows your architecture.Without Configurations
Prompt: “Create a user profile view with avatar and sign-out”With Configurations
Same prompt, same AI tool:Customization
Modifying Cursor Rules
Edit.mdc files in .cursor/rules/. Each file has YAML frontmatter (description, globs, alwaysApply) followed by markdown sections with good/bad code examples. Changes take effect when you save.
Modifying CLAUDE.md
EditCLAUDE.md in your project root. Add your own patterns, anti-patterns, or module-specific instructions. Claude picks up changes on the next conversation.
Adding Bolt Chat Modes
Edit.bolt/chat-modes.json to add custom modes:
Documentation
Agentic Development Setup
CLAUDE.md details and community skills
Cursor Rules README
Detailed guide on Cursor AI rules
Architecture Guide
The patterns AI follows
DesignSystem Guide
Design tokens reference
Questions
Do I need Claude Code, Cursor, or Bolt?
Do I need Claude Code, Cursor, or Bolt?
None of them are required. All three are supported. Claude Code works best for agentic development (building full features from a description). Cursor works best for inline code generation while you edit. Bolt works best for chat-based task switching. Use whichever fits your workflow, or combine them.
Can I use other AI assistants?
Can I use other AI assistants?
Yes. The patterns in CLAUDE.md and
.mdc files work as reference for any AI tool. You can paste relevant sections into ChatGPT, Copilot, or any assistant that accepts context.Will this slow down my development?
Will this slow down my development?
The opposite. AI configurations make code generation faster and more accurate because the AI gets it right the first time. Less time fixing, more time shipping.
Can I modify the configurations?
Can I modify the configurations?
Yes. Edit
CLAUDE.md, .cursor/rules/*.mdc, or .bolt/chat-modes.json to match your preferences. Changes take effect immediately (Cursor, Bolt) or on the next conversation (Claude Code).Do the rules apply to my manually-written code?
Do the rules apply to my manually-written code?
No. These configurations only guide AI code generation. They don’t lint or enforce anything on code you write by hand.
Next Steps
Build Your First Feature
Use AI to build a feature with your project’s patterns
Architecture Overview
Understand the patterns AI follows
Testing Guide
Let AI write tests for your features
