ios-paywall-creator 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 iOS Paywall Creator Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/QUICKSTART.md

@@ -0,0 +1,185 @@
+# Quick Start Guide
+
+Get your iOS paywall up and running in 15 minutes.
+
+## Installation
+
+```bash
+# Clone to your Claude skills directory
+git clone https://github.com/yourusername/ios-paywall-creator.git ~/.claude/skills/ios-paywall-creator
+```
+
+Or download and extract to `~/.claude/skills/ios-paywall-creator/`
+
+## Step-by-Step Guide
+
+### 1. Start the Conversation (1 min)
+
+Open Claude Code in your iOS project and say:
+
+```
+"Help me create a paywall for my app with weekly, monthly, and yearly subscriptions"
+```
+
+The skill will activate automatically.
+
+### 2. Plan Your Products (2 min)
+
+Answer Claude's questions:
+
+- **Product type:** Subscriptions or IAP?
+- **Where shown:** Hard paywall, settings, or first launch?
+- **Features:** What's locked behind the paywall?
+
+**Example:**
+```
+"Auto-renewing subscriptions"
+"Hard paywall blocking premium features"
+"Free users get 5 features, premium users get unlimited"
+```
+
+### 3. Configure App Store Connect (5 min)
+
+Follow Claude's step-by-step instructions to:
+
+1. Go to [App Store Connect](https://appstoreconnect.apple.com)
+2. Create a Subscription Group
+3. Add weekly/monthly/yearly subscriptions
+4. Set pricing
+
+**Tip:** Keep the App Store Connect tab open - you'll need the IDs next.
+
+### 4. Provide Your Product IDs (1 min)
+
+Claude will ask for:
+
+```
+Subscription Group ID: 21995608
+Weekly Product ID: com.yourapp.premium.weekly
+Monthly Product ID: com.yourapp.premium.monthly
+Yearly Product ID: com.yourapp.premium.yearly
+```
+
+Copy these from App Store Connect and paste them into Claude.
+
+### 5. Choose Your Design (2 min)
+
+Either:
+
+**Option A:** Upload a screenshot of a paywall you like
+
+**Option B:** Choose from generated themes:
+- Modern Minimalist (navy + electric blue)
+- Warm & Friendly (peach + coral)
+- Bold & Premium (purple gradient + gold)
+
+**Option C:** Describe your vision:
+```
+"Soft gradient, calm colors, zen aesthetic"
+```
+
+### 6. Get Your Code (2 min)
+
+Claude generates:
+
+```
+✅ StoreKitManager.swift (all IDs configured)
+✅ PaywallView.swift (your custom design)
+✅ Integration instructions
+```
+
+**All product IDs are already in the code - just copy and paste!**
+
+### 7. Integrate (2 min)
+
+1. Create `StoreKitManager.swift` in your Xcode project
+2. Create `PaywallView.swift` in your Xcode project
+3. Add initialization code to your App struct:
+
+```swift
+@main
+struct YourApp: App {
+    init() {
+        StoreKitManager.shared.configure()
+    }
+
+    var body: some Scene {
+        WindowGroup {
+            ContentView()
+        }
+    }
+}
+```
+
+4. Show the paywall where needed:
+
+```swift
+.sheet(isPresented: $showPaywall) {
+    PaywallView()
+}
+```
+
+### 8. Test (Optional)
+
+Create a StoreKit Configuration File in Xcode:
+1. File → New → StoreKit Configuration File
+2. Add your products manually
+3. Run your app and test purchases
+
+## What You Get
+
+- ✅ Full StoreKit 2 implementation
+- ✅ Transaction observer for real-time updates
+- ✅ Custom paywall UI
+- ✅ Legal compliance (Terms, Privacy, auto-renewal text)
+- ✅ Restore purchases functionality
+- ✅ No manual ID configuration needed
+
+## Common First-Time Questions
+
+**Q: Do I need a backend server?**
+A: No, StoreKit handles everything. Backend sync is optional.
+
+**Q: Can I customize the colors after generation?**
+A: Yes! Search for `Color(` in PaywallView.swift and adjust hex values.
+
+**Q: What if I want different subscription tiers later?**
+A: Just run the skill again with your new product IDs.
+
+**Q: How do I test without real money?**
+A: Use Xcode's StoreKit Configuration File or App Store Connect sandbox testers.
+
+**Q: Does this work with SwiftUI only?**
+A: The generated PaywallView is SwiftUI, but StoreKitManager works with UIKit too.
+
+## Troubleshooting
+
+**Products not loading?**
+- Check product IDs are exact (case-sensitive)
+- Verify "Cleared for Sale" in App Store Connect
+- Try `try await AppStore.sync()`
+
+**Build errors?**
+- Ensure you're targeting iOS 15+ for StoreKit 2
+- Import Foundation and StoreKit at the top
+
+**Paywall doesn't show?**
+- Check your `showPaywall` state binding
+- Verify StoreKitManager was initialized
+
+## Next Steps
+
+- Add paywall to multiple locations (settings, features, first launch)
+- Customize UI colors and layout
+- Test thoroughly in sandbox environment
+- Submit to App Store Review
+
+## Need Help?
+
+- [Full Documentation](SKILL.md)
+- [Examples](examples/)
+- [GitHub Issues](https://github.com/yourusername/ios-paywall-creator/issues)
+
+---
+
+**Time to production-ready paywall: ~15 minutes** ⚡

package/README.md

@@ -0,0 +1,233 @@
+# iOS Paywall Creator
+
+> **A Claude Code skill that helps iOS developers create production-ready paywalls with native StoreKit 2 integration.**
+
+Transform your iOS app monetization from zero to production-ready in minutes. This skill guides you through the complete process—from App Store Connect setup to beautiful, functional paywall UI—with no placeholders or manual configuration needed.
+
+[![npm version](https://img.shields.io/npm/v/ios-paywall-creator.svg)](https://www.npmjs.com/package/ios-paywall-creator)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+## 🎯 What This Skill Does
+
+The iOS Paywall Creator is an interactive guide that walks you through:
+
+1. **Product Planning** - Define your subscription tiers or in-app purchases
+2. **App Store Connect Setup** - Step-by-step guidance for creating subscriptions/IAP
+3. **ID Collection** - Captures your actual product IDs and subscription group ID
+4. **Design Direction** - Work from inspiration images or choose from generated themes
+5. **Code Generation** - Produces production-ready Swift code with your actual IDs pre-configured
+
+**The Result:** Copy-paste ready `StoreKitManager.swift` and `PaywallView.swift` files that work immediately—no manual editing required.
+
+## 🚀 Quick Start
+
+### Installation
+
+**Option 1: Quick Install with npx (Recommended)**
+```bash
+npx ios-paywall-creator
+```
+
+**Option 2: Install from GitHub**
+```bash
+npx github:krythz43/ios-paywall-creator-skill
+```
+
+**Option 3: Global Installation**
+```bash
+npm install -g ios-paywall-creator
+```
+
+**Option 4: Manual Git Clone**
+```bash
+git clone https://github.com/krythz43/ios-paywall-creator-skill.git ~/.claude/skills/ios-paywall-creator
+```
+
+That's it! The skill will be installed to `~/.claude/skills/ios-paywall-creator` automatically.
+
+### Prerequisites
+
+- macOS with Xcode installed
+- Active Apple Developer account
+- App Store Connect access
+- An iOS app project (SwiftUI preferred)
+
+### Usage
+
+Open Claude Code and say:
+
+```
+"Help me create a paywall for my iOS app"
+"Add StoreKit subscriptions to my app"
+"I need to monetize my app with in-app purchases"
+"Create a paywall with weekly, monthly, and yearly subscriptions"
+```
+
+The skill will automatically activate and guide you through the process.
+
+## 📋 Features
+
+### Comprehensive Guidance
+
+- **No Experience Required** - Step-by-step instructions for App Store Connect
+- **Multiple Product Types** - Supports auto-renewing subscriptions, consumable IAP, and non-consumable IAP
+- **Flexible Integration** - Hard paywalls, soft paywalls, feature gates, or settings pages
+
+### Design Flexibility
+
+- **Inspiration-Based** - Provide a screenshot of a paywall you like
+- **Theme Generator** - Choose from pre-designed aesthetic options
+- **Custom Styling** - Describe your vision and get matching UI code
+
+### Production-Ready Code
+
+- **StoreKit 2** - Modern async/await patterns with proper error handling
+- **Transaction Observer** - Real-time subscription status updates
+- **Receipt Verification** - Secure transaction validation
+- **Restore Purchases** - Built-in restoration flow
+- **Legal Compliance** - Terms of Service, Privacy Policy, and required App Store text
+
+### Zero Configuration
+
+- **Actual IDs Used** - Your product IDs are inserted directly into generated code
+- **No Placeholders** - No "YOUR_APP_ID" or manual find-and-replace needed
+- **Copy-Paste Ready** - Generated files work immediately in your project
+
+## 💡 Example Workflow
+
+```
+You: "I want to add subscriptions to my meditation app"
+
+Claude (via skill):
+1. Asks about your monetization needs (subscriptions vs IAP)
+2. Helps you plan pricing tiers (weekly/monthly/yearly)
+3. Guides you through App Store Connect setup
+4. Collects your actual product IDs:
+   - "com.yourapp.premium.weekly"
+   - "com.yourapp.premium.monthly"
+   - "com.yourapp.premium.yearly"
+   - Subscription Group ID: "21995608"
+5. Asks for design inspiration
+6. Generates complete Swift files with YOUR IDs already configured
+```
+
+**Output:**
+- `StoreKitManager.swift` - Full StoreKit 2 implementation
+- `PaywallView.swift` - Custom UI matching your design
+- Integration instructions for your specific use case
+- Testing checklist
+
+## 📚 What You Get
+
+### StoreKitManager.swift
+- Transaction observer for real-time updates
+- Product loading with error handling
+- Purchase flow with verification
+- Subscription status checking
+- Restore purchases functionality
+- Support for multiple tiers or IAP types
+
+### PaywallView.swift
+- Custom-designed UI based on your inspiration
+- Subscription selection interface
+- Feature comparison (if applicable)
+- Legal text (Terms, Privacy, auto-renewal notice)
+- Loading and error states
+- Restore purchases button
+
+### Integration Code
+- App initialization
+- Where to present the paywall
+- Feature gating examples
+- First-launch detection
+
+## 🎨 Design Approach
+
+The skill follows modern iOS design principles:
+
+- **Distinctive, Not Generic** - Avoids cookie-cutter templates
+- **Context-Aware** - Matches your app's aesthetic
+- **Accessibility-First** - Proper labels and hints
+- **Dark Mode Support** - Uses adaptive colors
+- **Human-Centered** - Clear value propositions, readable legal text
+
+## 🔧 Advanced Features
+
+### Multiple Subscription Tiers
+Generate code for Basic/Premium/Ultimate tier structures with proper upgrade/downgrade handling.
+
+### Consumable IAP
+Includes token/credit purchasing with local or backend balance tracking.
+
+### Backend Integration
+Optional patterns for syncing purchases with your server for cross-platform access.
+
+### Introductory Offers
+Support for free trials and promotional pricing (configured in App Store Connect).
+
+## 📖 Documentation
+
+- [SKILL.md](SKILL.md) - Complete skill implementation
+- [references/storekit-manager-template.md](references/storekit-manager-template.md) - StoreKit patterns
+- [references/paywall-ui-patterns.md](references/paywall-ui-patterns.md) - UI components and integration
+- [examples/](examples/) - Real usage scenarios
+
+## 🧪 Testing
+
+The generated code includes:
+
+- Sandbox testing instructions
+- StoreKit Configuration File guidance
+- Common issues and solutions
+- Testing checklist for App Store Review
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit issues or pull requests.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 📝 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- Built for [Claude Code](https://claude.ai/code) by Anthropic
+- StoreKit 2 patterns from Apple's documentation
+
+## 🐛 Troubleshooting
+
+### Products Not Loading
+- Verify product IDs match exactly (case-sensitive)
+- Check that products are "Cleared for Sale" in App Store Connect
+- Ensure subscription group exists
+- Try `try await AppStore.sync()`
+
+### Purchase Doesn't Update Status
+- Verify transaction observer is initialized
+- Check `checkPurchasedProducts()` is called after purchase
+- Review `Transaction.currentEntitlements` logic
+
+### UI Issues on Small Screens
+- Test on iPhone SE (smallest screen)
+- Use `GeometryReader` for adaptive sizing
+- Add `.minimumScaleFactor()` to text
+
+## 💬 Support
+
+- Open an issue on [GitHub](https://github.com/krythz43/ios-paywall-creator-skill/issues)
+- Check existing issues for solutions
+- Share your experience and help others
+
+## 🌟 Star History
+
+If this skill helped you, please consider giving it a star! ⭐
+
+---
+
+**Made with ❤️ for the vibe coding community**