Release version 1.0.1

- Add Twig template engine integration
- Migrate all templates to Twig format
- Add German (Switzerland, Informal) translation
- Improve template organization and security
- Add Composer dependency management
- Create comprehensive changelog

USAGE_EXAMPLES.md

@@ -0,0 +1,171 @@
+# Usage Examples
+
+## Example 1: T-Shirt Store with Volume Discounts
+
+### Tier Pricing Setup
+
+For a t-shirt that normally costs $20:
+
+| Min Quantity | Price per Unit | Customer Saves |
+|--------------|----------------|----------------|
+| 1            | $20.00         | -              |
+| 10           | $18.00         | $2.00 (10%)    |
+| 25           | $16.00         | $4.00 (20%)    |
+| 50           | $14.00         | $6.00 (30%)    |
+
+**How to configure:**
+1. Edit your t-shirt product
+2. Set regular price to $20.00
+3. Add tier: Min Qty = 10, Price = $18.00
+4. Add tier: Min Qty = 25, Price = $16.00
+5. Add tier: Min Qty = 50, Price = $14.00
+6. Save product
+
+**Customer experience:**
+- Buys 5 shirts: $20.00 each = $100.00 total
+- Buys 15 shirts: $18.00 each = $270.00 total (saves $30)
+- Buys 30 shirts: $16.00 each = $480.00 total (saves $120)
+
+## Example 2: Office Supplies with Package Deals
+
+### Package Pricing Setup
+
+For pens that normally cost $2.00 each:
+
+| Package      | Quantity | Fixed Price | Price per Unit |
+|--------------|----------|-------------|----------------|
+| Single       | 1        | $2.00       | $2.00          |
+| Small Pack   | 12       | $20.00      | $1.67          |
+| Value Pack   | 24       | $36.00      | $1.50          |
+| Bulk Pack    | 50       | $65.00      | $1.30          |
+
+**How to configure:**
+1. Edit your pen product
+2. Set regular price to $2.00
+3. Add package: Qty = 12, Price = $20.00, Label = "Small Pack"
+4. Add package: Qty = 24, Price = $36.00, Label = "Value Pack"
+5. Add package: Qty = 50, Price = $65.00, Label = "Bulk Pack"
+6. Save product
+
+**Customer experience:**
+- Customer sees package cards on product page
+- Clicks "Select Package" for "Value Pack"
+- Quantity automatically set to 24
+- Price shows $36.00 (not $48.00)
+
+## Example 3: Combined Tier and Package Pricing
+
+### Coffee Beans Store
+
+For premium coffee beans at $15.00 per bag:
+
+**Tier Pricing:**
+- 1-4 bags: $15.00 each
+- 5-9 bags: $14.00 each
+- 10+ bags: $13.00 each
+
+**Package Deals:**
+- Monthly subscription: 4 bags for $50.00 ($12.50 each)
+- Quarterly bundle: 12 bags for $140.00 ($11.67 each)
+
+**How to configure:**
+1. Set regular price: $15.00
+2. Add tier: Min Qty = 5, Price = $14.00
+3. Add tier: Min Qty = 10, Price = $13.00
+4. Add package: Qty = 4, Price = $50.00, Label = "Monthly Box"
+5. Add package: Qty = 12, Price = $140.00, Label = "Quarterly Bundle"
+
+**Customer scenarios:**
+- Buys 3 bags: $15.00 each = $45.00
+- Buys 4 bags: Gets prompted for Monthly Box at $50.00
+- Buys 6 bags: $14.00 each = $84.00 (tier pricing)
+- Buys 12 bags: Gets Quarterly Bundle at $140.00 (package beats tier)
+
+## Example 4: Promotional Packages
+
+### Seasonal Gift Sets
+
+Regular mug price: $10.00
+
+**Package Deals:**
+- Pair Pack: 2 mugs for $18.00 (10% off)
+- Family Set: 4 mugs for $32.00 (20% off)
+- Office Bundle: 10 mugs for $70.00 (30% off)
+
+**Configuration:**
+- Package 1: Qty = 2, Price = $18.00, Label = "Perfect Pair"
+- Package 2: Qty = 4, Price = $32.00, Label = "Family Set"
+- Package 3: Qty = 10, Price = $70.00, Label = "Office Bundle"
+
+## Tips for Best Results
+
+### Tier Pricing Best Practices
+
+1. **Progressive Discounts**: Make higher quantities more attractive
+   - Good: 10 items = 10% off, 25 items = 20% off, 50 items = 30% off
+   - Bad: 10 items = 20% off, 25 items = 15% off
+
+2. **Clear Break Points**: Use round numbers for quantities
+   - Good: 10, 25, 50, 100
+   - Avoid: 7, 23, 47, 93
+
+3. **Meaningful Savings**: Ensure discounts are worth the extra purchase
+   - Minimum 5-10% per tier level
+   - Higher tiers should have progressively better deals
+
+### Package Pricing Best Practices
+
+1. **Strategic Quantities**: Match common use cases
+   - 12-pack (dozen)
+   - 24-pack (two dozen)
+   - 6-pack (half dozen)
+
+2. **Compelling Labels**: Make packages attractive
+   - "Starter Pack" instead of "10-piece"
+   - "Family Bundle" instead of "4-pack"
+   - "Business Value Pack" instead of "50-piece"
+
+3. **Sweet Spot Pricing**: Price just below psychological barriers
+   - $99.99 instead of $100.00
+   - $49.95 instead of $50.00
+
+### Combining Both Strategies
+
+1. Use **packages** for common quantities (6, 12, 24)
+2. Use **tiers** for flexible volume discounts (10+, 25+, 50+)
+3. Packages take priority when exact match exists
+4. Tiers fill the gaps between packages
+
+## Display Position Recommendations
+
+- **Before Add to Cart**: Best for products where pricing is the main decision factor
+- **After Add to Cart**: Good for impulse purchases and upsells
+- **After Price**: Ideal for clean product pages, keeps info near the price
+
+## Testing Your Setup
+
+1. Add a product to your store
+2. Configure tier/package pricing
+3. View the product page in an incognito window
+4. Test different quantities
+5. Verify prices update correctly
+6. Add to cart and check cart totals
+7. Complete a test checkout
+
+## Common Scenarios
+
+### Wholesale Store
+- Tier 1: 10+ items = wholesale price tier 1
+- Tier 2: 50+ items = wholesale price tier 2
+- Tier 3: 100+ items = wholesale price tier 3
+
+### Subscription Box
+- Package 1: 1 month (4 items) = $40
+- Package 2: 3 months (12 items) = $108 (10% off)
+- Package 3: 6 months (24 items) = $192 (20% off)
+
+### Event Supplies
+- Package 1: Small party (10 pieces) = $50
+- Package 2: Medium party (25 pieces) = $110
+- Package 3: Large party (50 pieces) = $200
+- Package 4: Event package (100 pieces) = $350