🍎 SubsForge Extension

Apple-inspired subscription management for VS Code

Features

🎨 Apple HIG Design

• Beautiful Icon: Unique Apple-inspired gradient icon
• Smooth Animations: Delightful micro-interactions and transitions
• Apple Colors: System color palette with proper contrast
• Typography: Apple font scale and spacing system

🚀 Core Functionality

• Product Management: Create and manage subscription products
• Plan Creation: Design subscription plans with pricing tiers
• Provider Integration: Support for Lemon Squeezy and Stripe
• Code Generation: Insert checkout snippets automatically
• Real-time Status: Connection status and sync indicators

Installation

From VSIX Package

1. Download the latest VSIX: subsforge-extension-0.1.12.vsix
2. Open VS Code
3. Go to Extensions (Ctrl+Shift+X)
4. Click "..." menu → "Install from VSIX..."
5. Select the downloaded file

Command Line

code --install-extension subsforge-extension-0.1.12.vsix

Quick Start

1. Setup Provider: Use SubsForge: Setup Provider command
2. Create Product: Run SubsForge: Create Subscription Product
3. Add Plans: Use SubsForge: Create Subscription Plan
4. Insert Code: Run SubsForge: Insert Checkout Snippet

Commands

Apple HIG Features

Visual Design

• ✅ Apple system colors and gradients
• ✅ Proper typography hierarchy
• ✅ Consistent spacing and layout
• ✅ Smooth animations and transitions

User Experience

• ✅ Delightful micro-interactions
• ✅ Progressive feedback
• ✅ Apple-style status indicators
• ✅ Intuitive navigation patterns

Accessibility

• ✅ High contrast ratios
• ✅ Proper semantic HTML
• ✅ Screen reader compatibility
• ✅ Keyboard navigation support

Configuration

Settings

{
  "subsforge.backendUrl": "http://localhost:4000",
  "subsforge.testConnectionOnStartup": false,
  "subsforge.providers": {
    "lemonsqueezy": {
      "storeId": "your-store-id"
    },
    "stripe": {
      "publishableKey": "your-key"
    }
  }
}

Environment Variables

SUBSFORGE_API_TOKEN=your-api-token
LEMONSQUEEZY_API_KEY=your-lemon-key
STRIPE_SECRET_KEY=your-stripe-key

Requirements

• VS Code 1.85.0 or higher
• Node.js 18+ (for local development)
• SubsForge backend service

Development

Setup

# Clone repository
git clone https://github.com/FinsavvyTechnologies/subsforge.dev.git
cd subsforge.dev/apps/vscode-extension

# Install dependencies
npm install

# Build extension
npm run build

# Run tests
npm test

Build VSIX

# Using build script
./build-and-package-extension.sh patch

# Or directly
node simple-vsix-builder.js

Icon Design

The extension icon features:

• Gradient Background: Apple system blue to purple gradient
• Document Symbol: Represents subscription contracts
• Checkmark: Indicates active subscriptions
• Settings Gear: Represents customization options
• Apple Aesthetics: Follows Apple HIG guidelines

Support

• Documentation: Apple HIG Implementation
• Issues: GitHub Issues
• Website: SubsForge.dev

Publisher

FinsavvyTechnologies 🍎 Building beautiful developer tools with Apple-inspired design

License

MIT License - see LICENSE file for details.

Made with ❤️ and Apple HIG principles 🍎