https://github.com/ivan-bondaruk/personinitialsavatar

https://github.com/ivan-bondaruk/personinitialsavatar

ios library macos swiftui ui ui-design xcode

Last synced: 8 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/ivan-bondaruk/personinitialsavatar
• Owner: Ivan-Bondaruk
• License: mit
• Created: 2025-06-15T13:28:54.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2025-06-15T14:01:50.000Z (9 months ago)
• Last Synced: 2025-06-15T15:11:27.986Z (9 months ago)
• Topics: ios, library, macos, swiftui, ui, ui-design, xcode
• Language: Swift
• Homepage:
• Size: 5.86 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Person Initials Avatar

![Version](https://img.shields.io/badge/version-1.0.2-blue)

![Platform](https://img.shields.io/badge/platform-iOS%20%7C%20macOS-lightgrey)

![SwiftUI](https://img.shields.io/badge/SwiftUI-Compatible-brightgreen)

![License](https://img.shields.io/badge/license-MIT-green)

**PersonInitialsAvatar** is a SwiftUI component that displays a clean text avatar. Easily customizable and perfect for apps that want to present contact or professional information in a stylish way.

## ✨ Features

- Simple design

- SwiftUI-native

- Fully customizable: full name, size and background color

- Works on both iOS and macOS

- Lightweight and dependency-free

## 🛠 Installation

### 📦 Swift Package Manager (SPM)

You can add this package directly through **Xcode**:

1. Open your project in Xcode.

2. Go to **File > Add Packages...**

3. Enter the URL of the repository: [https://github.com/Ivan-Bondaruk/PersonInitialsAvatar]()

4. Select version `1.0.2` or **Up to Next Major**.

5. Click **Add Package**.

That's it! The package is now ready to use in your SwiftUI project.

## 💻 Requirements

- iOS 13.0+ / macOS 13.0+

- Xcode 16

- Swift 6.1

- SwiftUI framework

## Screenshot

![Screenshot](Images/PersonAvatarGradient.png)

- Package include only AvatarView not more like text on screenshot

## 🧩 Usage

```swift

import PersonInitialAvatar

PersonInitialsAvatarView(fullName: "Ivan Bondaruk", diameter: 100)

// OR

PersonInitialsAvatarView(fullName: "Ivan Bondaruk", diameter: 100, backgroundColor: .secondary)

// For gradient background use another view

ProfessionalPersonInitialAvatarView(fullName: "Ivan Bondaruk", diameter: 100, gradientColors: [.purple, .secondary])

// OR

ProfessionalPersonInitialAvatarView(fullName: "Ivan Bondaruk", diameter: 100)