Skip to content

Adding Tuist Article#60

Merged
leogdion merged 15 commits intomainfrom
59-tuist-article
Apr 27, 2026
Merged

Adding Tuist Article#60
leogdion merged 15 commits intomainfrom
59-tuist-article

Conversation

@leogdion
Copy link
Copy Markdown
Member

@leogdion leogdion commented Apr 25, 2026

Summary by CodeRabbit

  • Documentation
    • Updated mise setup guide with corrected terminology, revised tool versions, GitHub Actions CI integration examples, and enhanced iOS/Swift project guidance
    • Added new comprehensive tutorial on Tuist for Xcode project generation and configuration, covering deployment targets, App Store resources, automated versioning, and code signing
    • Updated development environment launch configurations

leogdion and others added 11 commits April 25, 2026 12:44
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Fix deployTargets → deploymentTargets (actual Tuist parameter name)
- Add mise setup guide link before tuist init command
- Bridge the two Project.swift examples so readers understand the switch from buildableFolders to sources
- Remove filler phrases and fix remaining grammar/spelling issues
- Replace dangling Privacy Manifest link with Apple's official docs

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@leogdion leogdion linked an issue Apr 25, 2026 that may be closed by this pull request
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 25, 2026

Warning

Rate limit exceeded

@leogdion has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 54 minutes and 14 seconds before requesting another review.

To keep reviews running without waiting, you can enable usage-based add-on for your organization. This allows additional reviews beyond the hourly cap. Account admins can enable it under billing.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 5ea6402a-979f-4c97-bfc4-cb8e8ad8eb6c

📥 Commits

Reviewing files that changed from the base of the PR and between 27ce046 and b20bfaf.

📒 Files selected for processing (2)
  • Content/tutorials/mise-setup-guide.md
  • Content/tutorials/tuist-xcode-project-setup.md
📝 Walkthrough

Walkthrough

The PR updates Visual Studio Code debug configuration to use Swift target settings instead of explicit program paths, revises the mise setup tutorial with refreshed tooling pins and GitHub Actions examples, and introduces a new Tuist project setup tutorial for Xcode.

Changes

Cohort / File(s) Summary
VSCode Configuration
.vscode/launch.json
Switches Debug and Release launch configs from explicit program binary paths to Swift target/configuration settings while maintaining preLaunchTask references.
Tutorial Updates
Content/tutorials/mise-setup-guide.md
Updates tool versions, revises GitHub Actions CI examples, removes production patterns and some troubleshooting sections, adds trust-after-clone guidance, refocuses content on iOS/Swift projects, and corrects terminology.
New Tutorial Documentation
Content/tutorials/tuist-xcode-project-setup.md
Introduces comprehensive guide covering Tuist setup, Xcode project generation, deployment targets, App Store requirements, version management, and .gitignore configuration for generated artifacts.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related issues

  • Add Tuist Article #59: Directly corresponds to the new tuist-xcode-project-setup.md tutorial documentation added in this PR.

Possibly related PRs

Poem

🐰 Hop skip and jump through configs we go,
VSCode learns to target the flow,
Mise gets polished, fresh and bright,
Tuist now shines in tutorial light,
Documentation blooms, the garden's all set! 🌱

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'Adding Tuist Article' directly and clearly identifies the primary change: introducing new documentation for Tuist project setup, which represents the main addition (395 lines) in this changeset.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch 59-tuist-article

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 3

🧹 Nitpick comments (3)
Content/tutorials/mise-setup-guide.md (1)

21-21: Minor copy polish to improve tone and concision.

Line [21] (“in order to”) and Line [207] (“we'll talk about”) are a bit verbose/informal for the otherwise polished tutorial voice. Consider tightening these two phrases.

Also applies to: 207-207

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@Content/tutorials/mise-setup-guide.md` at line 21, Replace verbose/informal
phrases in the markdown: change "in order to" (found in the sentence starting "I
want an isolated environment when I use CI in order to have a repeatable
environment...") to a tighter alternative like "to" and replace "we'll talk
about" (around Line 207) with a more formal phrase like "this guide covers" or
"we cover"; update both occurrences to match the tutorial's polished, concise
tone while preserving meaning.
Content/tutorials/tuist-xcode-project-setup.md (2)

17-17: Tighten grammar in key explanatory paragraphs.

There are several typos/grammar slips in core tutorial text (e.g., “convert it an Xcode project”, “out sets of targets”, “Esentially”, “intializer”, “now development team is set”). These reduce credibility and clarity of an otherwise strong guide.

Also applies to: 121-121, 125-125, 154-154, 228-228

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@Content/tutorials/tuist-xcode-project-setup.md` at line 17, The paragraph has
multiple grammar and spelling issues that should be corrected for clarity: fix
"There’s 2 leading tools" -> "There are two leading tools", "convert it an Xcode
project" -> "convert it into an Xcode project", "Tuist is what I’d recommend in
most any other case." -> "I recommend Tuist in most other cases.", and change
"not committing Xcode projects to your code repository" to "avoid committing
Xcode projects to your repository"; also scan and correct the other flagged
lines (e.g., replace "out sets of targets" with "sets of targets", "Esentially"
-> "Essentially", "intializer" -> "initializer", and "now development team is
set" -> "now the development team is set") while ensuring consistent punctuation
and tone across the tutorial.

25-27: Add language identifiers to fenced code blocks (MD040).

Several fenced blocks are unlabeled, which hurts syntax highlighting and lint compliance. Please tag them (bash, text, gitignore, etc.) consistently.

Suggested patch
-```
+```bash
 mise exec tuist -- tuist init

- +bash
mise exec tuist -- tuist edit


-```
+```bash
mise exec tuist -- tuist generate

- +properties
MARKETING_VERSION = 1.0.0
CURRENT_PROJECT_VERSION = 2


-```
+```text
$(ALL_UPPER_CASE_SNAKE_CASE_PROPERTY_FROM_CONFIGURATION_SETTINGS)

- +text
https://www.toptal.com/developers/gitignore/api/xcode,swift,swiftpackagemanager,swiftpm,macos


-```
+```gitignore
# *.xcodeproj

- +gitignore
*.xcodeproj


-```
+```gitignore
*.xcworkspace

- +gitignore
.tuist/
Derived/

Also applies to: 73-75, 81-83, 263-266, 288-290, 352-354, 358-360, 364-366, 370-372, 376-379

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@Content/tutorials/tuist-xcode-project-setup.md` around lines 25 - 27, Update
all unlabeled fenced code blocks in
Content/tutorials/tuist-xcode-project-setup.md to include appropriate language
identifiers for syntax highlighting and linting (MD040); for example, label
command blocks containing "mise exec tuist -- tuist init", "mise exec tuist --
tuist edit", and "mise exec tuist -- tuist generate" as bash, mark the block
with "MARKETING_VERSION = 1.0.0" and "CURRENT_PROJECT_VERSION = 2" as
properties, label plain text placeholders like
"$(ALL_UPPER_CASE_SNAKE_CASE_PROPERTY_FROM_CONFIGURATION_SETTINGS)" and the URL
"https://www.toptal.com/developers/gitignore/api/xcode,swift,swiftpackagemanager,swiftpm,macos"
as text, and mark the gitignore examples (lines containing "# *.xcodeproj",
"*.xcodeproj", "*.xcworkspace", ".tuist/", "Derived/") as gitignore; apply the
same labeling consistently to the other occurrences called out (around lines
73–75, 81–83, 263–266, 288–290, 352–354, 358–360, 364–366, 370–372, 376–379).
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@Content/tutorials/mise-setup-guide.md`:
- Line 204: The tutorial image tag missing alt text should be updated to include
an accessible description: modify the <img
src="/media/tutorials/mise-setup-guide/mise-development-tools.webp"
class="full-size" /> element to add a meaningful alt attribute (e.g. alt="Mise
development tools and setup overview") so screen readers and accessibility
checks pass; ensure the alt string succinctly describes the image content and
intent.

In `@Content/tutorials/tuist-xcode-project-setup.md`:
- Line 91: The heading "Projects and their Targets" is using H3 (###) after an
H1, breaking Markdown heading hierarchy; change that heading to H2 (## Projects
and their Targets) or insert an intermediate H2 section before it so the
document progresses H1 → H2 → H3 properly to restore valid structure and fix
TOC/reader tooling issues.
- Line 216: The image tag <img
src="/media/tutorials/tuist-xcode-project-setup/AppStore-ITSAppUsesNonExemptEncryption.png"
class="full-size" /> is missing an alt attribute; update this element (the App
Store screenshot image) to include a concise, descriptive alt text (for example:
alt="App Store export compliance dialog showing ITSAppUsesNonExemptEncryption")
to fix the accessibility regression.

---

Nitpick comments:
In `@Content/tutorials/mise-setup-guide.md`:
- Line 21: Replace verbose/informal phrases in the markdown: change "in order
to" (found in the sentence starting "I want an isolated environment when I use
CI in order to have a repeatable environment...") to a tighter alternative like
"to" and replace "we'll talk about" (around Line 207) with a more formal phrase
like "this guide covers" or "we cover"; update both occurrences to match the
tutorial's polished, concise tone while preserving meaning.

In `@Content/tutorials/tuist-xcode-project-setup.md`:
- Line 17: The paragraph has multiple grammar and spelling issues that should be
corrected for clarity: fix "There’s 2 leading tools" -> "There are two leading
tools", "convert it an Xcode project" -> "convert it into an Xcode project",
"Tuist is what I’d recommend in most any other case." -> "I recommend Tuist in
most other cases.", and change "not committing Xcode projects to your code
repository" to "avoid committing Xcode projects to your repository"; also scan
and correct the other flagged lines (e.g., replace "out sets of targets" with
"sets of targets", "Esentially" -> "Essentially", "intializer" -> "initializer",
and "now development team is set" -> "now the development team is set") while
ensuring consistent punctuation and tone across the tutorial.
- Around line 25-27: Update all unlabeled fenced code blocks in
Content/tutorials/tuist-xcode-project-setup.md to include appropriate language
identifiers for syntax highlighting and linting (MD040); for example, label
command blocks containing "mise exec tuist -- tuist init", "mise exec tuist --
tuist edit", and "mise exec tuist -- tuist generate" as bash, mark the block
with "MARKETING_VERSION = 1.0.0" and "CURRENT_PROJECT_VERSION = 2" as
properties, label plain text placeholders like
"$(ALL_UPPER_CASE_SNAKE_CASE_PROPERTY_FROM_CONFIGURATION_SETTINGS)" and the URL
"https://www.toptal.com/developers/gitignore/api/xcode,swift,swiftpackagemanager,swiftpm,macos"
as text, and mark the gitignore examples (lines containing "# *.xcodeproj",
"*.xcodeproj", "*.xcworkspace", ".tuist/", "Derived/") as gitignore; apply the
same labeling consistently to the other occurrences called out (around lines
73–75, 81–83, 263–266, 288–290, 352–354, 358–360, 364–366, 370–372, 376–379).
🪄 Autofix (Beta)

✅ Autofix completed


ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: b089dbb2-2ce5-4d78-82cc-3ac44c615719

📥 Commits

Reviewing files that changed from the base of the PR and between 3681ae7 and 27ce046.

⛔ Files ignored due to path filters (1)
  • Resources/media/tutorials/tuist-xcode-project-setup/AppStore-ITSAppUsesNonExemptEncryption.png is excluded by !**/*.png
📒 Files selected for processing (9)
  • .vscode/launch.json
  • Content/tutorials/mise-setup-guide.md
  • Content/tutorials/tuist-xcode-project-setup.md
  • Resources/media/tutorials/mise-setup-guide/mise-development-tools.webp
  • Resources/media/tutorials/tuist-xcode-project-setup/Swift-Automation-Tuist.webp
  • Resources/media/tutorials/tuist-xcode-project-setup/tuist-xcode-hero.webp
  • Resources/media/tutorials/tuist-xcode-project-setup/xcode-destinations-dropdown.webp
  • Resources/media/tutorials/tuist-xcode-project-setup/xcode-minimum-deployments.webp
  • Resources/media/tutorials/tuist-xcode-project-setup/xcode-signing-requires-team.webp

Comment thread Content/tutorials/mise-setup-guide.md Outdated
Comment thread Content/tutorials/tuist-xcode-project-setup.md Outdated
Comment thread Content/tutorials/tuist-xcode-project-setup.md Outdated
leogdion and others added 2 commits April 27, 2026 09:45
- Fix mise exec tuist commands to use direct invocation with shell integration
- Add Homebrew as alternative install path with anchored links to mise guide
- Clarify tuist edit save behavior and contrast with direct editing
- Strengthen warning against editing generated Xcode project directly
- Mention XcodeGen/YAML as alternative for static-config preference
- Pin Tuist version to 4.188.1 in .mise.toml example with explanation
- Add named anchors (#homebrew, #why-mise, #shell-integration) to mise guide

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 27, 2026

Note

Autofix is a beta feature. Expect some limitations and changes as we gather feedback and continue to improve it.

Fixes Applied Successfully

Fixed 2 file(s) based on 3 unresolved review comments.

A stacked PR containing fixes has been created.

  • Stacked PR: #61
  • Files modified:
  • Content/tutorials/mise-setup-guide.md
  • Content/tutorials/tuist-xcode-project-setup.md

Time taken: 1m 18s

Fixed 2 file(s) based on 3 unresolved review comments.

Co-authored-by: CodeRabbit <noreply@coderabbit.ai>
@leogdion leogdion merged commit 3f29cf2 into main Apr 27, 2026
2 of 3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add Tuist Article

1 participant