shipany_skill

Overview

This skill provides AI-powered, hands-on documentation and guidance for building SaaS apps with the Shipany framework. It covers Next.js 15, TypeScript, Drizzle ORM, NextAuth, payment integration, and common SaaS patterns to speed implementation and debugging. Use it to find examples, configuration tips, and deployment advice tailored to Shipany projects.

How this skill works

The skill inspects common Shipany areas: authentication flows, database models, API routes, UI components, and payment integrations. It maps documented patterns and examples to practical steps, recommends configuration values, and surfaces code snippets for Next.js 15 and TypeScript. Use the references to locate detailed files on API, authentication, database, deployment, and payments.

When to use it

• Starting a new Shipany SaaS project or integrating Shipany into Next.js 15
• Implementing authentication with NextAuth and Shipany conventions
• Designing database schemas or queries using Drizzle ORM patterns
• Adding or debugging payment flows and billing logic
• Preparing deployment and environment configuration for production

Best practices

• Follow the getting started guide first to initialize project structure and TypeScript settings
• Model persistent data with Drizzle ORM migrations and keep schema definitions versioned
• Centralize auth routes with NextAuth and validate server-side session checks for protected APIs
• Use typed API route handlers to keep client-server contracts explicit and maintainable
• Isolate payment logic and webhooks, verify signatures, and test billing flows in sandbox mode

Example use cases

• Scaffold a Shipany-based SaaS app with Next.js 15 and TypeScript starter templates
• Implement role-based access using NextAuth and Shipany-provided middleware patterns
• Create Drizzle ORM models for tenants, subscriptions, and usage metrics
• Integrate Stripe payments, handle webhooks, and reconcile invoices in the app
• Prepare CI/CD deployment with environment variable management and recommended build steps