@oriro/orirocli 0.1.0

package/skills/technical/mobile-pwa/SKILL.md

@@ -0,0 +1,191 @@
+---
+watermark: ORIRO
+name: mobile-pwa
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+description: >
+  Mobile development and PWA — React Native, Expo, iOS/Android deployment,
+  Progressive Web Apps, push notifications, and mobile-specific patterns.
+  Activate for questions about building mobile apps, Expo/React Native,
+  app store submission, PWA, or any mobile development question.
+---
+
+# Mobile Development and PWA
+
+## React Native + Expo
+
+### Why Expo
+
+Write once, run on iOS + Android + Web. Managed workflow handles native build complexity.
+Expo Go: Test instantly on device without building. Expo EAS Build: Build in cloud.
+
+### Project structure
+
+```
+my-app/
+├── app/           # Expo Router file-based navigation
+│   ├── _layout.tsx
+│   ├── index.tsx  # Home (/)
+│   └── (tabs)/
+│       ├── _layout.tsx
+│       └── profile.tsx
+├── components/    # Shared UI
+├── hooks/         # Custom hooks
+├── lib/           # Utilities, API clients
+└── assets/        # Images, fonts
+```
+
+### Navigation (Expo Router — recommended)
+
+```tsx
+// app/(tabs)/_layout.tsx
+import { Tabs } from 'expo-router';
+
+export default function TabLayout() {
+  return (
+    <Tabs>
+      <Tabs.Screen name="index" options={{ title: 'Home', tabBarIcon: ... }} />
+      <Tabs.Screen name="profile" options={{ title: 'Profile', tabBarIcon: ... }} />
+    </Tabs>
+  );
+}
+
+// Navigate programmatically
+import { router } from 'expo-router';
+router.push('/profile');
+router.replace('/login');
+router.back();
+```
+
+### Core React Native components
+
+```tsx
+import {
+  View,
+  Text,
+  Image,
+  ScrollView,
+  TouchableOpacity,
+  TextInput,
+  StyleSheet,
+} from "react-native";
+import { SafeAreaView } from "react-native-safe-area-context";
+
+// StyleSheet is more performant than inline styles
+const styles = StyleSheet.create({
+  container: { flex: 1, padding: 16, backgroundColor: "#fff" },
+  title: { fontSize: 24, fontWeight: "bold", color: "#111" },
+});
+```
+
+### Platform differences to watch
+
+```tsx
+import { Platform } from "react-native";
+
+const styles = StyleSheet.create({
+  shadow: Platform.select({
+    ios: { shadowColor: "#000", shadowOffset: { width: 0, height: 2 }, shadowOpacity: 0.1 },
+    android: { elevation: 4 },
+  }),
+});
+```
+
+### Push notifications (Expo)
+
+```ts
+import * as Notifications from "expo-notifications";
+
+// Request permission
+const { status } = await Notifications.requestPermissionsAsync();
+
+// Get push token (send to backend to store)
+const token = await Notifications.getExpoPushTokenAsync({
+  projectId: Constants.expoConfig.extra.eas.projectId,
+});
+
+// Handle notification when app is open
+Notifications.addNotificationReceivedListener((notification) => {
+  console.log(notification);
+});
+```
+
+## App Store Deployment
+
+### iOS (App Store)
+
+**Requirements:** Apple Developer account ($99/year), Xcode, provisioning profiles.
+**Build:** `eas build --platform ios` or `eas build --platform all`
+**Submit:** `eas submit --platform ios` or via App Store Connect manually.
+**Review:** 1-5 business days typical. Screenshots for all device sizes required.
+**Key metadata:** App name, subtitle, description, keywords (100 char limit, comma-separated), categories.
+
+### Android (Google Play)
+
+**Requirements:** Google Play Console account ($25 one-time), AAB (Android App Bundle) not APK.
+**Build:** `eas build --platform android`
+**Submit:** `eas submit --platform android` or via Google Play Console.
+**Review:** Few hours to days. Less strict than iOS typically.
+**Staged rollout:** Release to 1%, 5%, 10%, 20%, 50%, 100% of users progressively.
+
+### eas.json configuration
+
+```json
+{
+  "build": {
+    "development": {
+      "developmentClient": true,
+      "distribution": "internal"
+    },
+    "preview": {
+      "distribution": "internal"
+    },
+    "production": {}
+  }
+}
+```
+
+## Progressive Web Apps (PWA)
+
+### What makes a PWA
+
+**Service Worker:** Background JavaScript that enables offline capability, caching, push notifications.
+**Web App Manifest:** JSON file making the app installable.
+**HTTPS:** Required for service workers and many PWA features.
+**Responsive design:** Works on all screen sizes.
+
+### Manifest (manifest.json)
+
+```json
+{
+  "name": "My App",
+  "short_name": "MyApp",
+  "description": "Description",
+  "start_url": "/",
+  "display": "standalone",
+  "background_color": "#ffffff",
+  "theme_color": "#3b82f6",
+  "icons": [
+    { "src": "/icon-192.png", "sizes": "192x192", "type": "image/png" },
+    { "src": "/icon-512.png", "sizes": "512x512", "type": "image/png" }
+  ]
+}
+```
+
+### Service Worker caching strategies
+
+**Cache First:** Check cache, then network if not found. Good for static assets.
+**Network First:** Try network, fall back to cache. Good for API calls.
+**Stale While Revalidate:** Return cached immediately, update in background.
+
+**Next.js PWA:** Use `next-pwa` package. Handles service worker generation automatically.
+
+## Mobile-specific design patterns
+
+**Touch targets:** Minimum 44×44 points (iOS) / 48×48 dp (Android). Larger than desktop buttons.
+**Safe areas:** iPhone notch/home indicator, Android status bar. Use SafeAreaView.
+**Keyboard avoidance:** KeyboardAvoidingView wraps forms so keyboard doesn't cover inputs.
+**Haptic feedback:** `expo-haptics` for physical feedback on interactions.
+**Offline first:** Design for intermittent connectivity. TanStack Query + MMKV persistence.
+
+Sources: Expo documentation (docs.expo.dev — free), React Native docs (reactnative.dev — free), Apple Human Interface Guidelines (free), Material Design guidelines (free), web.dev PWA docs (free)

package/skills/technical/no-code-tools/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ORIRO.ai
+
+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/skills/technical/no-code-tools/SKILL.md

@@ -0,0 +1,80 @@
+---
+watermark: ORIRO
+disable-model-invocation: true
+name: no-code-tools
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+description: >
+
+
+
+
+  No-code and low-code tools — building apps without coding, automation, integration platforms, and when to use no-code.
+  Sources: Technical documentation, public guidelines, industry best practices.
+---
+
+# No-Code and Low-Code Tools
+
+## When to use no-code
+
+**Use no-code when:**
+
+- Speed to market matters more than customization
+- Non-technical team member needs to own it
+- Volume is low enough that limitations don't matter
+- Validating an idea before investing in custom development
+- Internal tools where limited users tolerate constraints
+- Automating repetitive manual work
+
+**Use custom code when:**
+
+- Need deep customization or complex business logic
+- High-scale, performance-critical
+- Building a core product users pay for
+- Security/compliance requirements exceed no-code platform guarantees
+- No-code platform limitations are limiting growth
+
+## Tool categories
+
+### App builders
+
+**Bubble:** Full web app builder. Database, logic, UI. Complex apps possible but learning curve. Good for marketplaces, SaaS.
+**Webflow:** Beautiful websites and CMSs. Web design tool that generates clean code. Not a full app builder.
+**Softr:** Turn Airtable/Google Sheets into a portal or app. Fast, limited.
+**Glide:** Mobile apps from Google Sheets. Good for internal tools.
+**Retool:** Internal tools (admin panels, dashboards). Uses SQL and APIs. Fastest for internal use cases.
+
+### Automation and integration
+
+**Zapier:** Connect 6,000+ apps. Trigger → Action. Easy, expensive at scale.
+**Make (Integromat):** More powerful than Zapier. Visual workflow. Cheaper for complex scenarios.
+**n8n:** Open source Zapier/Make alternative. Self-host. More technical but no per-task fees.
+**Airtable:** Database + automation + app. Swiss army knife for structured data workflows.
+
+### AI automation
+
+**Relevance AI:** AI agent and tool builder without code.
+**Stack AI:** Build and deploy AI workflows.
+**Voiceflow:** Conversation and voice AI builder.
+
+### Website builders
+
+**Framer:** Design-first. AI generates site from description. Beautiful, fast.
+**Squarespace/Wix:** Template-based. For simple business sites, portfolios.
+**Webflow (repeat):** Best for agencies and more complex marketing sites.
+
+## No-code platform limitations to know
+
+**Bubble limitations:** Performance at scale not great. Proprietary platform risk (vendor lock-in). Difficult to migrate off.
+**Zapier cost:** $0.01+ per task at volume. 100,000 tasks/month = $1,000+.
+**Vendor lock-in:** Your data and logic live on their platform. What happens if they raise prices or shut down? Have an exit plan.
+**Security:** Your data lives on a third-party platform. Review their SOC 2, data handling, GDPR compliance before using for sensitive data.
+
+## Making no-code work
+
+Export your data regularly. Maintain a spreadsheet or database backup.
+Document your workflows as if someone else will need to maintain them.
+Consider the long-term: Is this a permanent solution or a bridge until you can build properly?
+Performance: Test at expected scale, not just proof-of-concept scale.
+
+Sources: No-code platform documentation, Makerpad (free no-code education), Ben Tossell's no-code resources, Product Hunt no-code discussion

package/skills/technical/open-source/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ORIRO.ai
+
+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/skills/technical/open-source/SKILL.md

@@ -0,0 +1,71 @@
+---
+watermark: ORIRO
+name: open-source
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+description: >
+  Open source development — licenses, contributing to open source, GitHub workflow,
+  governance models, and building sustainable open source projects.
+  Sources: OSI (opensource.org — free), GitHub guides (free), FOSS community norms.
+---
+
+# Open Source Development
+
+## License types
+
+### Permissive licenses (most free)
+
+**MIT:** Do anything. Must keep copyright notice. Used by: React, Vue, Rails, jQuery.
+**Apache 2.0:** Like MIT + explicit patent grant. Used by: Android, Kubernetes, TensorFlow.
+**BSD 2-Clause:** Similar to MIT. Used by FreeBSD.
+
+### Copyleft licenses (viral)
+
+**GPL v2/v3:** Derived works must also be GPL. Used by: Linux kernel (v2), GCC, WordPress.
+**LGPL:** Like GPL but allows linking from proprietary software. Used by Qt.
+**AGPL:** GPL + covers SaaS deployments. Used by MongoDB (community), Nextcloud.
+
+### Creative Commons (content, not code)
+
+**CC-BY:** Attribution required. Most permissive for content.
+**CC-BY-SA:** Share-alike. Derived works same license.
+**CC0:** Public domain dedication. No restrictions whatsoever.
+
+## Contributing to open source
+
+### First contribution workflow
+
+1. Fork the repo on GitHub.
+2. Clone your fork: `git clone https://github.com/yourusername/project.git`
+3. Create feature branch: `git checkout -b fix-typo-readme`
+4. Make changes.
+5. Commit: `git commit -m "fix: correct typo in README installation section"`
+6. Push: `git push origin fix-typo-readme`
+7. Open Pull Request on GitHub from your fork to upstream main.
+
+### Commit message convention (Conventional Commits)
+
+`type(scope): description`
+Types: feat, fix, docs, style, refactor, test, chore.
+Example: `feat(auth): add OAuth2 Google sign-in`
+
+### Good first contributions
+
+Documentation improvements, typo fixes, adding tests, fixing small bugs.
+Look for: Issues labeled "good first issue" or "help wanted."
+
+## Open source governance models
+
+**BDFL:** Benevolent Dictator for Life. Python (Guido), Linux (Linus).
+**Foundation governance:** Apache Software Foundation, Linux Foundation, CNCF.
+**Company-backed:** React (Meta), Kubernetes (Google/CNCF).
+**Consensus:** Most decisions by maintainer consensus. RFC process for big changes.
+
+## Sustainable open source
+
+Open Collective, GitHub Sponsors, OpenSSF for funding.
+Dual licensing: Open source community + paid commercial license.
+Open-core: Core free, enterprise features paid. GitLab, Mattermost model.
+
+Sources: OSI (opensource.org — free), Choose A License (choosealicense.com — free),
+GitHub Open Source Guides (free)

package/skills/technical/performance-optimization/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ORIRO.ai
+
+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/skills/technical/performance-optimization/SKILL.md

@@ -0,0 +1,155 @@
+---
+watermark: ORIRO
+name: performance-optimization
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+description: >
+
+
+
+
+
+
+  Web performance optimization — profiling, bundle size, rendering, caching, CDN, database optimization, and measurement.
+
+
+
+
+
+  Sources: Google Search Central, GDPR text, AWS security documentation, Stripe API docs.
+---
+
+# Web Performance Optimization
+
+## Measure first, optimize second
+
+**Never optimize without measuring.** Optimization without measurement = guessing.
+**Tools:**
+
+- Chrome DevTools Performance panel: CPU profiling, waterfall.
+- Lighthouse: Overall score, specific recommendations.
+- WebPageTest: Real-device testing, waterfall, filmstrip.
+- Core Web Vitals report in Google Search Console: Real user data.
+
+```bash
+# Lighthouse CLI
+npx lighthouse https://example.com --view
+
+# Check bundle size
+npx bundlesize
+```
+
+## Frontend performance
+
+### Bundle optimization
+
+```ts
+// Dynamic imports — only load code when needed
+const HeavyChart = dynamic(() => import('../components/HeavyChart'), {
+  loading: () => <Spinner />,
+  ssr: false // if not needed server-side
+});
+
+// Next.js bundle analyzer
+// next.config.js
+const withBundleAnalyzer = require('@next/bundle-analyzer')({ enabled: process.env.ANALYZE === 'true' });
+module.exports = withBundleAnalyzer({});
+// Run: ANALYZE=true npm run build
+```
+
+**Tree shaking:** Import specific named exports, not entire libraries.
+
+```ts
+// BAD: Imports entire lodash (71KB)
+import _ from "lodash";
+const sorted = _.sortBy(arr, "name");
+
+// GOOD: Import only what you use
+import sortBy from "lodash/sortBy";
+// Or use native alternatives
+const sorted = [...arr].sort((a, b) => a.name.localeCompare(b.name));
+```
+
+### Image optimization
+
+WebP: 25-35% smaller than JPEG. AVIF: 50% smaller but less support.
+
+```html
+<!-- Responsive images -->
+<img
+  srcset="image-320.webp 320w, image-640.webp 640w, image-1280.webp 1280w"
+  sizes="(max-width: 640px) 320px, (max-width: 1280px) 640px, 1280px"
+  src="image-1280.webp"
+  alt="Description"
+  width="1280"
+  height="720"
+  loading="lazy"  <!-- or "eager" for above-the-fold -->
+/>
+```
+
+### Critical rendering path
+
+```html
+<!-- Preload critical resources -->
+<link rel="preload" href="/fonts/inter.woff2" as="font" crossorigin />
+<link rel="preload" href="/hero.webp" as="image" fetchpriority="high" />
+
+<!-- Defer non-critical scripts -->
+<script src="analytics.js" defer></script>
+<script src="chat-widget.js" async></script>
+```
+
+**Inline critical CSS:** CSS required for above-the-fold content. Load rest async.
+
+## Backend performance
+
+### Database optimization
+
+N+1 queries: The most common performance killer.
+
+```ts
+// BAD: N+1
+const posts = await db.post.findMany();
+for (const post of posts) {
+  post.author = await db.user.findUnique({ where: { id: post.authorId } }); // N queries!
+}
+
+// GOOD: One query with include
+const posts = await db.post.findMany({
+  include: { author: { select: { id: true, name: true, avatar: true } } },
+});
+```
+
+**EXPLAIN ANALYZE:** Run on slow queries. Look for: Sequential Scans on large tables (need indexes), high row estimates vs. actuals (stale statistics), Nested Loops on large datasets.
+
+### Caching
+
+```ts
+// Redis caching with stale-while-revalidate pattern
+async function getCachedData(key: string, fetchFn: () => Promise<any>, ttl: number) {
+  const cached = await redis.get(key);
+  if (cached) {
+    // Refresh in background if close to expiry
+    const ttlRemaining = await redis.ttl(key);
+    if (ttlRemaining < ttl * 0.1) {
+      fetchFn().then((data) => redis.setex(key, ttl, JSON.stringify(data)));
+    }
+    return JSON.parse(cached);
+  }
+  const data = await fetchFn();
+  await redis.setex(key, ttl, JSON.stringify(data));
+  return data;
+}
+```
+
+**Cache layers (fastest to slowest):**
+Browser cache → CDN cache → Application memory cache → Redis → Database
+
+## CDN and edge
+
+**Static assets:** 1-year cache with content hash in URL (file.abc123.js).
+**HTML:** Short cache or cache-control: no-store for dynamic pages.
+**API responses:** Cache GET responses at CDN when possible (public, not user-specific).
+**Cloudflare Workers / Vercel Edge:** Move logic to edge for lower latency globally.
+
+Sources: web.dev performance (free), Google Chrome DevTools documentation (free), Next.js optimization docs (free), WebPageTest (free tool)

package/skills/technical/pricing-design/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ORIRO.ai
+
+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/skills/technical/pricing-design/SKILL.md

@@ -0,0 +1,87 @@
+---
+watermark: ORIRO
+name: pricing-design
+provider: ORIRO.ai
+copyright: Copyright (c) 2026 ORIRO.ai
+description: >
+
+
+
+
+  Pricing strategy for tech products — value-based pricing, tiers, freemium, trials, anchoring, and pricing page design.
+
+
+
+
+
+
+
+  Sources: Google Search Central, GDPR text, AWS security documentation, Stripe API docs.
+---
+
+# Pricing Design for Tech Products
+
+## Pricing strategy foundations
+
+### Value-based pricing (the right approach)
+
+Price = fraction of value delivered, NOT cost-plus.
+**Question:** What is this worth to the customer?
+A tool saving a developer 1 hour/week × $100/hour × 52 weeks = $5,200/year value.
+Capture 10-20% of value = $520-1,040/year = $43-87/month.
+Most companies underprice by 30-50% because they price on cost or competitor benchmarks.
+
+### Identifying your value metric
+
+What you charge should scale with value delivered.
+
+- **Seats/users:** Good when each user generates proportional value. Slack, Figma.
+- **Usage:** Good when value scales with consumption. Twilio (per message), AWS (per compute hour).
+- **Revenue %:** Marketplace/payment tools. Stripe (2.9%), Shopify.
+- **Outcomes:** Increasingly common. Charge a % of value created.
+- **Features:** Tiered access. Freemium/Basic/Pro/Enterprise.
+
+## Tier design
+
+### The 3-tier structure (most common)
+
+**Free/Starter:** Real value, removes friction to try. Designed to convert. Show the core workflow.
+**Pro/Growth:** For individual power users or small teams. Most of your revenue.
+**Business/Enterprise:** Team features, SSO, compliance, SLA, support. High price, few customers, significant revenue.
+
+**Anchoring:** Present tiers highest to lowest (right to left on pricing page). Middle option gets 60-70% of conversions in well-designed pricing pages.
+**Decoy pricing:** Three tiers where the middle is "just right" makes the middle seem like the obvious choice.
+
+### What to gate
+
+**Free → Pro:** Collaboration, advanced features, higher limits, integrations, priority support.
+**Pro → Enterprise:** SSO/SAML, audit logs, custom contracts, dedicated support, SLA, compliance certifications, unlimited.
+
+## Freemium vs. Free Trial
+
+|                     | Freemium                               | Free Trial                         |
+| ------------------- | -------------------------------------- | ---------------------------------- |
+| **Access**          | Limited features forever               | Full features, limited time        |
+| **User gets**       | Permanent but constrained              | Full experience, then paywall      |
+| **Best for**        | Viral/social products, network effects | Complex products needing full demo |
+| **Conversion rate** | 2-5% (Dropbox, Slack)                  | 20-60% of trials (varies)          |
+| **Risk**            | Generous enough to not convert         | Short enough to create urgency     |
+
+**Hybrid:** Free plan + time-limited trial of premium features.
+
+## Psychological pricing principles
+
+**Price anchoring:** Show the highest tier first. Makes other tiers feel reasonable.
+**Charm pricing:** $29 vs. $30 — marginal psychological effect.
+**Annual vs. monthly:** Offer annual at 2 months free (17% discount). Improves retention + cash flow.
+**Per-seat transparency:** "Billed per user" should be crystal clear. Hidden per-user fees = trust destruction.
+**Social proof on pricing page:** Logos of customers, "X,000 companies" counter, testimonials.
+
+## Pricing page design
+
+**CTA clarity:** One CTA per tier. "Get started" or "Start free trial" — not "Learn more."
+**Feature comparison table:** Long list of features is noise. Lead with outcomes/benefits, then features.
+**FAQ section:** Address: "What happens after my trial?", "Can I cancel?", "Do you offer refunds?", "What counts as a seat?"
+**Contact for Enterprise:** Always a "contact us" option for custom pricing. Doesn't end the sale.
+
+Sources: Patrick McKenzie pricing posts (free, stripe.com/atlas/guides), PriceIntelligently (by Paddle — free research), HBR pricing strategy articles (some free), Wiio pricing research