https://github.com/SimformSolutionsPvtLtd/SSSwiftUISideMenu

SSSwiftUISideMenu: Your ultimate iOS side menu companion. This customizable and intuitive library facilitates seamless navigation within your app, offering left and right panel support. Effortlessly integrate and personalize UI elements and animation styles to elevate your user experience.
https://github.com/SimformSolutionsPvtLtd/SSSwiftUISideMenu

animation appdevelopment codecustomization codeintegration customization developertools iosdev library mobiledev navigation opensource sidemenu swiftui uiux userexperience

Last synced: 21 days ago
JSON representation

Host: GitHub
URL: https://github.com/SimformSolutionsPvtLtd/SSSwiftUISideMenu
Owner: SimformSolutionsPvtLtd
License: mit
Created: 2022-10-18T06:12:59.000Z (over 3 years ago)
Default Branch: master
Last Pushed: 2023-12-29T06:29:49.000Z (about 2 years ago)
Last Synced: 2026-02-21T01:51:05.705Z (about 1 month ago)
Topics: animation, appdevelopment, codecustomization, codeintegration, customization, developertools, iosdev, library, mobiledev, navigation, opensource, sidemenu, swiftui, uiux, userexperience
Language: Swift
Homepage:
Size: 2.18 MB
Stars: 33
Watchers: 9
Forks: 3
Open Issues: 1
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

awesome-mobile-libraries - SSSwiftUISideMenu - SSSwiftUISideMenu: Effortless Side Navigation in SwiftUI. Create sleek and customizable side menus effortlessly in SwiftUI with SSSwiftUISideMenu. (iOS / SwiftUI)

README

          

# SSSwiftUISideMenu

[![Version](https://img.shields.io/cocoapods/v/SSSwiftUISideMenu.svg?style=flat)](https://cocoapods.org/pods/SSSwiftUISideMenu)

[![Platform](https://img.shields.io/cocoapods/p/SSSwiftUISideMenu.svg?style=flat)](https://cocoapods.org/pods/SSSwiftUISideMenu)

[![Swift Version][swift-image]][swift-url]

[![PRs Welcome][PR-image]][PR-url]

[![Twitter](https://img.shields.io/badge/Twitter-@simform-blue.svg?style=flat)](https://twitter.com/simform)

SSSwiftUISideMenu: Effortless Side Navigation in SwiftUI

Create sleek and customizable side menus effortlessly in SwiftUI with SSSwiftUISideMenu. This SwiftUI library simplifies the implementation of side menus, allowing you to enhance the navigation and user experience of your iOS apps. With a focus on flexibility and ease of use, SSSwiftUISideMenu empowers developers to integrate stylish side menus seamlessly into their SwiftUI projects.

## Features

- [x] Highly customizable

- [x] Multiple options of animations

- [x] Right panel support

### Requirements

- iOS 13.0+

- Xcode 11.0+

- [CocoaPods](http://cocoapods.org/)

## Example

![Example of SSSwiftUISideMenu](GIFs/MainGif.gif)

*An example of Custom SideMenu created with this library*

![SSSwiftUISideMenu_example](https://github.com/SimformSolutionsPvtLtd/SSSwiftUISideMenu/assets/63283381/9c70c998-26ed-48b4-8aff-3ee44bf727a8)

- To run the example project, clone the repo, and run `pod install` from the Example directory first.

# Installation

#### CocoaPods

- You can use CocoaPods to install `SSSwiftUISideMenu` by adding it to your Podfile:

       use_frameworks!

       pod 'SSSwiftUISideMenu'

- Import SSSwiftUISideMenu in your file:

       import SSSwiftUISideMenu

**Manually**

- Download and drop **SSSwiftUISideMenu/Sources** folder in your project.

- Grab yourself a cold 🍺.

#### Swift Package Manager (SPM)

-   When using Xcode 11 or later, you can install `SSSwiftUISideMenu` by going to your Project settings > `Swift Packages` and add the repository by providing the GitHub URL. Alternatively, you can go to `File` > `Swift Packages` > `Add Package Dependencies...`

         dependencies: [

             .package(url: "https://github.com/mobile-simformsolutions/SSSwiftUISideMenu.git", from: "1.0.0")

         ]

# Usage Examples

- Import the package in the file you would like to use it: 

```swiftui

import SSSwiftUISideMenu

```

- This library shares one View which you can use as a sidemenu with many customizations like UI, animation, direction and many more.

Basic example:

```swift

    @State private var openSideMenu: Bool = false

    

    @State private var selectedIndex: Int = 0

    

    private var menuItems = [

        MenuItem(title: "item_1", icon: "icon_1"),

        MenuItem(title: "item_2", icon: "icon_2"),

        MenuItem(title: "item_3", icon: "icon_3"),

        MenuItem(title: "item_4", icon: "icon_4")

    ]

var body: some Scene {

    SSSwiftUISideMenu(openSideMenu: $openSideMenu, selectedIndex: $selectedIndex, menuItems: menuItems)

}

```

The results of any interaction from sidemenu item will available in declared selectedIndex state variable. Also sidemnu open / close toggle value will be available in the openSideMenu state variable.

# Customizations

- You can customize almost every main thing in this library.

- For Customizations you have to pass another value of `menuConfig` during call of SSSwiftUISideMenu. This menuConfig argument is optional as well as Every arguments in `SSMenuConfig` is also Optional. So, you need to add only those arguments which yo wanted to customize. Here's the examples :

## Change in Style

-----

*An example of customisation of styles*

```swift

var body: some Scene {

    SSSwiftUISideMenu(openSideMenu: $openSideMenu, selectedIndex: $selectedIndex, menuItems: menuItems, 

        menuConfig: SSMenuConfig(titleColor: .black, 

                selectedTitleColor: .secondary, 

                backgroundColor: .white))

}

```

## Change SideMenu direction - Left / Right

-----

*An example of change sidemenu direction. left direction is default*

```swift

var body: some Scene {

    SSSwiftUISideMenu(openSideMenu: $openSideMenu, selectedIndex: $selectedIndex, menuItems: menuItems, 

        menuConfig: SSMenuConfig(menuDirection: .right))

}

```

## Add animation to your sidemenu

-----

*An example of applying a animation type to the sidemenu*

```swift

var body: some Scene {

    SSSwiftUISideMenu(openSideMenu: $openSideMenu, selectedIndex: $selectedIndex, menuItems: menuItems, 

        menuConfig: SSMenuConfig(animationType: .easeOut))

}

```

# Other Customizations

#### SideMenu width

----

*You can change the menu width of your choice with the menuWidth. By default is '280'.*


```swift

var body: some Scene {

    SSSwiftUISideMenu(openSideMenu: $openSideMenu, selectedIndex: $selectedIndex, menuItems: menuItems, 

        menuConfig: SSMenuConfig(menuWidth: MENU_SIZE))

}

```

#### Icon color and customizations

-------

- You can add leftIconPadding argument to change the icon padding from the left side of the sidemenu view.


- You can add imageToTitlePadding argument for adding a padding between a icon and title.


- You can add iconTintColor argument to change the icon tint color of your choice.


- You can add iconHeight and iconWidth argument change the size of the row icons.


```swift

var body: some Scene {

    SSSwiftUISideMenu(openSideMenu: $openSideMenu, selectedIndex: $selectedIndex, menuItems: menuItems, 

        menuConfig: SSMenuConfig(leftIconPadding: 20, 

                imageToTitlePadding: 15, 

                iconTintColor: .black, 

                iconHeight: 30, 

                iconWidth: 30))

}

```

#### Show App Version

-------

*An example of showing your app version at bottom of the sidemenu. you can configure its style and color. All are optionally configured.*

- Add showAppVersion argument to weather to show app versio or not. Default is false


- Add versionText argument for adding a pass the text of the version.


- Add versionTitleColor, versionAlignment or versionFont argument to change the font style and color of the version string.


```swift

var body: some Scene {

    SSSwiftUISideMenu(openSideMenu: $openSideMenu, selectedIndex: $selectedIndex, menuItems: menuItems, 

        menuConfig: SSMenuConfig(showAppVersion: true, 

                versionText: "1.0.0", 

                versionTitleColor: .gray, 

                versionAlignment: .center))

}

```

## Coming Soon

- Pass custom view directly to the sidemenu to create sidemenu of your choice.


**Up for a suggestions. Give suggestions for more features and customisations.**

## 🤝 How to Contribute

Whether you're helping us fix bugs, improve the docs, or a feature request, we'd love to have you! :muscle:

Check out our [**Contributing Guide**](CONTRIBUTING.md) for ideas on contributing.

## Find this example useful? ❤️

Give a ⭐️ if this project helped you!

## Check out our other Libraries

🗂 Simform Solutions Libraries→


## MIT License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details

[PR-image]:https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat

[PR-url]:http://makeapullrequest.com

[swift-image]:https://img.shields.io/badge/swift-5.0-orange.svg

[swift-url]: https://swift.org/

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/SimformSolutionsPvtLtd/SSSwiftUISideMenu

Awesome Lists containing this project

README

🗂 Simform Solutions Libraries→