A modern, SwiftUI-native "What's New" presentation framework designed for all Apple platforms. Featuring beautiful animations, gradient backgrounds, remote data loading, and comprehensive customization options for creating engaging release notes and feature announcements.

• ✨ Features
• 🎯 Quick Start
• 🎨 Preview & Gallery
• ⚙️ Configuration
• 🔧 Data Sources
• 🛠️ Platform Support
• 📁 Installation Guide
• 🔧 Troubleshooting
• 📂 Project Structure
• 🤝 Contributing

Light Native	Dark Native

History View (2.0.0+)	App Icon Support (3.9.6+)

VisionOS Support (4.1.0+)	Mesh Gradient Background (5.3.0+)

Add SwiftNEW to your project by adding the package URL in Xcode:

https://github.com/1998code/SwiftNEWKit 

1. Import the framework

import SwiftNEW

2. Create a simple "What's New" view

struct ContentView: View { @State private var showNew = false var body: some View { VStack { Text("My App") .font(.largeTitle) SwiftNEW(show: $showNew) } } }

3. Add your content Create a data.json file in your app bundle with your release notes:

[ { "version": "1.0", "new": [ { "icon": "star.fill", "title": "Welcome", "subtitle": "Get Started", "body": "Thanks for downloading our app! Here's what's new." } ] } ]

struct ContentView: View { @State private var showNew = false var body: some View { SwiftNEW( show: $showNew, color: .constant(.blue), size: .constant("normal"), label: .constant("What's New"), labelImage: .constant("sparkles"), history: .constant(true), mesh: .constant(true), glass: .constant(true) ) } }

Light Native	Dark Native

History View (2.0.0+)	App Icon Support (3.9.6+)

VisionOS Support (4.1.0+)	Mesh Gradient Background (5.3.0+)

*Required parameter

SwiftNEW(show: $showNew)

SwiftNEW( show: $showNew, color: .constant(.purple), size: .constant("normal"), mesh: .constant(true), glass: .constant(true) )

SwiftNEW( show: $showNew, data: .constant("https://api.example.com/releases.json") )

SwiftNEW( show: $showNew, label: .constant("New Update"), labelImage: .constant("bell.badge"), showDrop: .constant(true) )

SwiftNEW supports multiple data sources for maximum flexibility:

Create a JSON file in your app bundle (typically named data.json):

[ { "version": "1.2.0", "new": [ { "icon": "hammer.fill", "title": "Bug Fixes", "subtitle": "Stability Improvements", "body": "Resolved critical issues and improved overall app performance across all supported platforms." }, { "icon": "sparkles", "title": "New Features", "subtitle": "Enhanced Experience", "body": "Introduced exciting new capabilities including improved animations and modern UI components." }, { "icon": "shield.checkered", "title": "Security Updates", "subtitle": "Enhanced Protection", "body": "Strengthened security measures and updated encryption protocols for better data protection." } ] } ]

Load content from any REST API endpoint:

SwiftNEW( show: $showNew, data: .constant("https://api.myapp.com/releases.json") )

Direct integration with Firebase:

SwiftNEW( show: $showNew, data: .constant("https://your-project.firebaseio.com/releases.json") )

The JSON structure follows this model:

// Reference only - you don't need to implement this public struct Vmodel: Codable, Hashable { var version: String // Version number (e.g., "1.2.0") var subVersion: String? // Optional sub-version or build info var new: [Model] // Array of release items } public struct Model: Codable, Hashable { var icon: String // SF Symbol name (e.g., "star.fill") var title: String // Feature title var subtitle: String // Brief description var body: String // Detailed explanation }

• Local Files: Best for static content and faster loading
• Remote APIs: Ideal for dynamic content and A/B testing
• Firebase: Perfect for real-time updates and content management
• Version Format: Use semantic versioning (1.2.3) for better organization
• Content Length: Keep titles short, use body for detailed descriptions

Follow these steps to add SwiftNEW to your Xcode project:

Step	Action	Screenshot
1	Open your Xcode project and select the project file
2	Select your project target
3	Go to "Package Dependencies" tab
4	Click "+" and paste the repository URL
5	Choose your data source approach	See Data Sources section

https://github.com/1998code/SwiftNEWKit 

1. Import the framework in your Swift files:

import SwiftNEW

2. Create your data source (choose one):

   • Local: Add data.json to your app bundle
   • Remote: Use any JSON API endpoint
   • Firebase: Configure Firebase Realtime Database

3. Add to your view with minimal configuration:

SwiftNEW(show: $showNewVersion)

• Ensure the show binding is set to true
• Check that your data source (JSON file or URL) is accessible
• Verify the JSON format matches the expected structure

• For local files: Ensure data.json is added to your app bundle
• For remote URLs: Check network connectivity and URL validity
• Verify JSON structure matches the sample format

• Clean build folder (⌘+Shift+K)
• Update to latest Xcode version
• Ensure minimum platform requirements are met

• For large datasets, consider pagination
• Optimize image assets in your JSON data
• Use remote loading for better memory management

• Check GitHub Issues for known problems
• Search GitHub Discussions for community solutions
• Create a new issue with detailed information about your problem

Sources/SwiftNEW/ ├── SwiftNEW.swift # Main struct with initializers ├── Model.swift # Data models (Vmodel, Model) ├── Bundle+Ext.swift # Bundle extensions ├── Localizable.xcstrings # Localization support ├── 📁 Views/ │ ├── SwiftNEW+View.swift # Main body view implementation │ ├── 📁 Sheets/ │ │ ├── CurrentVersionSheet.swift # Current version display │ │ └── HistorySheet.swift # Version history display │ └── 📁 Components/ │ ├── HeaderView.swift # Header components │ └── ButtonComponents.swift # Button components ├── 📁 Extensions/ │ └── SwiftNEW+Functions.swift # Utility functions ├── 📁 Styles/ │ ├── AppIconView.swift # App icon display │ ├── MeshView.swift # Gradient backgrounds │ └── NoiseView.swift # Noise effects └── 📁 Animations/ └── SnowfallView.swift # Special effects (Christmas) 

SwiftNEW is built with a modular architecture that separates concerns for better maintainability:

• Core Components: Main struct and data models
• View Layer: Presentation components organized by functionality
• Extensions: Utility functions and framework extensions
• Styles: Visual components and gradient effects
• Animations: Special effects and interactive elements

We welcome contributions to SwiftNEW! Here's how you can help:

• 🐛 Report Bugs: Open an issue with detailed reproduction steps
• 💡 Request Features: Suggest new features or improvements
• 🔧 Submit Pull Requests: Fix bugs or implement new features
• 📚 Improve Documentation: Help make our docs clearer
• 🌍 Add Translations: Help us support more languages

1. Fork the repository
2. Clone your fork locally
3. Open Package.swift in Xcode
4. Make your changes
5. Test thoroughly across platforms
6. Submit a pull request

• Follow Swift naming conventions
• Maintain compatibility with minimum platform versions
• Add appropriate documentation comments
• Test on multiple platforms when possible
• Keep changes focused and atomic

• 💬 GitHub Discussions - Questions and community support
• 🐛 GitHub Issues - Bug reports and feature requests
• 📧 Contact the maintainer for complex questions

SwiftNEW is available under the MIT License. See the LICENSE file for details.

This documentation is available in multiple languages:

English | 繁中 / 简中 / 粵語 | 日本語 | 한국어

Help us add more languages by submitting translation pull requests!