DevSPMShowcase

DevSPMShowcase is an iOS SwiftUI demo app backed by a collection of small local Swift Package Manager libraries that model the kinds of components developers reuse in day-to-day product work.

The repo is designed to do two things:

1. demonstrate a working app that imports multiple local packages
2. provide a starter catalog of reusable Swift packages you can split out, refine, and publish independently

Demo Preview

What Is Included

This repository contains:

• an iOS demo app in DevSPMShowcase/
• a local Xcode project in DevSPMShowcase.xcodeproj
• 12 reusable Swift packages in Packages/

Package Catalog

Package	Purpose
ShimmerKit	Reusable shimmer animation for loading states
LoaderKit	Common animated loaders like dots, pulse, and bars
ToastKit	Lightweight toast presentation for transient feedback
SkeletonUI	Skeleton placeholder blocks for loading layouts
EmptyStateKit	Reusable empty state view with actions
ThemeKit	Shared theme tokens, colors, spacing, and button styles
FormValidatorKit	Simple validation rules for forms
NetworkMonitorKit	Network reachability status wrapper
DebounceKit	Async debouncer utility for user input and events
PaginationKit	Reusable pagination controller
ImageCacheKit	Cached async image loading utility
OnboardingKit	Reusable onboarding step and carousel UI

For a more detailed breakdown, see PACKAGES.md.

Project Structure

DevSPMShowcase/
├── DevSPMShowcase.xcodeproj
├── DevSPMShowcase/
│   ├── Assets.xcassets
│   └── DevSPMShowcaseApp.swift
├── Packages/
│   ├── ShimmerKit/
│   ├── LoaderKit/
│   ├── ToastKit/
│   ├── SkeletonUI/
│   ├── EmptyStateKit/
│   ├── ThemeKit/
│   ├── FormValidatorKit/
│   ├── NetworkMonitorKit/
│   ├── DebounceKit/
│   ├── PaginationKit/
│   ├── ImageCacheKit/
│   └── OnboardingKit/
├── DevSPMShowcaseTests/
└── DevSPMShowcaseUITests/

Demo App

The demo app is implemented in DevSPMShowcaseApp.swift and showcases:

• onboarding UI
• shimmer and skeleton loading states
• multiple loader styles
• toast presentation
• themed empty states
• form validation
• debounced input
• network status
• paginated content
• cached async image loading

Requirements

• Xcode 16+
• Swift 6+
• iOS 18 simulator runtime recommended
• Apple Silicon Mac recommended for the smoothest simulator experience

Running The Project

1. Open DevSPMShowcase.xcodeproj.
2. Select the DevSPMShowcase scheme.
3. Choose an iPhone simulator.
4. Build and run.

If Xcode tries to build with x86_64 simulator slices on Apple Silicon, the project already excludes x86_64 for simulator builds to avoid Rosetta-related linker issues.

How The Packages Are Wired

The app imports the local packages as Swift Package dependencies from the Packages/ directory. They are linked through the Xcode project and consumed like any other Swift package:

import ShimmerKit
import LoaderKit
import ToastKit

This keeps the app target clean while still making each package independently structured and easy to extract later.

Publishing Ideas

This repo is a strong starting point if you want to:

• publish the packages as standalone open source libraries
• create blog content or portfolio material around reusable iOS components
• learn how to organize a local multi-package Swift workspace
• evolve the demo app into a design-system playground

Documentation

• PACKAGES.md
• CONTRIBUTING.md

Next Improvements

• add screenshots or a demo GIF
• add tests for each package
• add package-specific README files
• choose and add a repository license
• publish selected packages as standalone GitHub repos or tags