Noora Text Formatting

Use this skill when a Swift CLI needs semantic terminal text instead of plain strings.

Compose TerminalText

Use TerminalText interpolation so Noora can render commands, links, and themed text correctly.

import Noora

let text = TerminalText("""
\(.raw("Project created."))
Run \(.command("swift run")) next.
Docs: \(.link(title: "Noora", href: "https://noora.tuist.dev"))
\(.primary("Primary"))
\(.secondary("Secondary"))
\(.muted("Muted"))
\(.accent("Accent"))
\(.danger("Danger"))
\(.success("Success"))
\(.info("Info"))
""")

Format It Explicitly

Use Noora().format(...) when you need a rendered string rather than a rendered component.

let rendered = Noora().format(text)
print(rendered)

Best Practices

• Use \(.command("...")) for executable commands instead of quoting them manually.
• Use \(.link(title:href:)) for documentation or dashboard links.
• Use semantic color components sparingly. Reserve them for status, emphasis, and scanability.
• Prefer TerminalText in alert takeaways and long-running step updates when you want richer output.

Avoid

• Concatenating ANSI escape codes by hand.
• Converting everything to raw strings too early.
• Using color semantics for large paragraphs. Keep emphasis local.