An open API service indexing awesome lists of open source software.

https://github.com/inkyzoid/sfsymbolspicker

Discover SFSymbolsPicker, a simple tool for selecting SF Symbols easily. Enhance your projects with this user-friendly app. πŸŒŸπŸš€
https://github.com/inkyzoid/sfsymbolspicker

apple icons ios jaywcjlove macos sfsymbols swift swift-package swift-package-manager swiftui swiftui-components symbols

Last synced: 2 months ago
JSON representation

Discover SFSymbolsPicker, a simple tool for selecting SF Symbols easily. Enhance your projects with this user-friendly app. πŸŒŸπŸš€

Awesome Lists containing this project

README

          

# SFSymbolsPicker: A SwiftUI Component for SF Symbols Selection

![SFSymbolsPicker](https://github.com/InkyZoid/SFSymbolsPicker/releases)
![SwiftUI](https://github.com/InkyZoid/SFSymbolsPicker/releases)
![macOS](https://github.com/InkyZoid/SFSymbolsPicker/releases)
![iOS](https://github.com/InkyZoid/SFSymbolsPicker/releases)

## Overview

SFSymbolsPicker is a SwiftUI view component designed for selecting SF Symbols in your macOS and iOS applications. It simplifies the integration of SF Symbols, making it easy for developers to implement a user-friendly symbol selection interface. This component is lightweight and flexible, allowing you to customize it according to your app's design needs.

## Features

- **SwiftUI Compatible**: Built with SwiftUI, ensuring a seamless integration into your projects.
- **User-Friendly Interface**: Provides an intuitive UI for selecting SF Symbols.
- **Customizable**: Tailor the appearance and behavior to fit your app's design.
- **Cross-Platform Support**: Works on both macOS and iOS.
- **Lightweight**: Minimal overhead for efficient performance.

## Installation

You can install SFSymbolsPicker using Swift Package Manager. Add the following line to your `https://github.com/InkyZoid/SFSymbolsPicker/releases` file:

```swift
.package(url: "https://github.com/InkyZoid/SFSymbolsPicker/releases", from: "1.0.0")
```

After adding the package, import it into your SwiftUI view:

```swift
import SFSymbolsPicker
```

## Usage

To use SFSymbolsPicker in your SwiftUI view, follow these steps:

1. **Import the Component**: Make sure to import SFSymbolsPicker.
2. **Add the Picker**: Include the `SFSymbolsPicker` in your view hierarchy.

Here’s a simple example:

```swift
struct ContentView: View {
@State private var selectedSymbol: String = "star"

var body: some View {
VStack {
SFSymbolsPicker(selectedSymbol: $selectedSymbol)
.frame(height: 300)
Text("Selected Symbol: \(selectedSymbol)")
.font(.largeTitle)
}
}
}
```

### Customization Options

You can customize the appearance of the picker using various parameters. Here are a few options:

- **Symbol Size**: Adjust the size of the symbols.
- **Background Color**: Change the background color of the picker.
- **Symbol Color**: Modify the color of the selected symbol.

Example:

```swift
SFSymbolsPicker(selectedSymbol: $selectedSymbol, symbolSize: 50, backgroundColor: .white, symbolColor: .blue)
```

## Examples

To see SFSymbolsPicker in action, check out the examples included in the repository. You can run these examples on your local machine to understand how to implement the component in different scenarios.

## Documentation

For detailed documentation, please refer to the [Wiki](https://github.com/InkyZoid/SFSymbolsPicker/releases). This includes setup instructions, usage examples, and API details.

## Release Information

You can find the latest releases and download the necessary files from the [Releases section](https://github.com/InkyZoid/SFSymbolsPicker/releases). Make sure to check for updates regularly.

## Topics

This repository covers a variety of topics relevant to iOS and macOS development:

- **Apple**: Learn how to use Apple's frameworks effectively.
- **iOS**: Explore the latest features in iOS development.
- **macOS**: Understand macOS-specific functionalities.
- **SF Symbols**: Get familiar with Apple's symbol library.
- **Swift**: Utilize Swift for modern application development.
- **Swift Package Manager**: Manage dependencies easily.
- **SwiftUI**: Leverage SwiftUI for building user interfaces.
- **SwiftUI Components**: Discover reusable components for SwiftUI.

## Contribution

Contributions are welcome! If you would like to contribute to SFSymbolsPicker, please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Make your changes and commit them.
4. Open a pull request.

Please ensure your code adheres to the existing style and includes appropriate tests.

## Issues

If you encounter any issues or have suggestions for improvements, please open an issue in the [Issues section](https://github.com/InkyZoid/SFSymbolsPicker/releases). We appreciate your feedback.

## License

SFSymbolsPicker is licensed under the MIT License. See the [LICENSE](LICENSE) file for more information.

## Acknowledgments

Special thanks to the developers and designers at Apple for creating SF Symbols and SwiftUI. Their work inspires developers to create beautiful applications.

## Additional Resources

- [Apple Developer Documentation](https://github.com/InkyZoid/SFSymbolsPicker/releases)
- [SwiftUI Tutorials](https://github.com/InkyZoid/SFSymbolsPicker/releases)
- [SF Symbols](https://github.com/InkyZoid/SFSymbolsPicker/releases)

For more information, visit the [Releases section](https://github.com/InkyZoid/SFSymbolsPicker/releases) to download the latest version and get started with SFSymbolsPicker.