shipd 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Anton
+
+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/README.md

@@ -0,0 +1,205 @@
+# Shipd CLI
+
+> Generate production-ready SaaS applications in minutes
+
+Shipd is a powerful CLI tool that generates complete SaaS applications with authentication, billing, user management, and a beautiful dashboard - all configured and ready to deploy.
+
+## Features
+
+- **Complete Authentication System** - Powered by Better Auth with Google OAuth, magic links, and secure session management
+- **Integrated Billing** - Polar.sh integration with subscription management and checkout flow
+- **Modern Tech Stack** - Next.js 15, React 19, TypeScript, Tailwind CSS, Drizzle ORM
+- **Database Ready** - PostgreSQL with Supabase integration out of the box
+- **Beautiful UI** - Pre-built dashboard, pricing page, and user management interface
+- **Production Ready** - Configured for deployment on Vercel and Railway
+- **Email System** - Resend integration for transactional emails
+- **TypeScript First** - Full type safety across the entire application
+
+## Installation
+
+You don't need to install Shipd globally. Use `npx` to run it directly:
+
+```bash
+npx shipd init my-saas-app
+```
+
+Or install globally:
+
+```bash
+npm install -g shipd
+```
+
+## Quick Start
+
+### 1. Authenticate
+
+First, authenticate with your Shipd account:
+
+```bash
+npx shipd login
+```
+
+This will open your browser for authentication. You'll need an active Shipd subscription to generate projects.
+
+### 2. Create Your Project
+
+Generate a new SaaS application:
+
+```bash
+npx shipd init my-saas-app
+```
+
+The CLI will:
+- Create a new Next.js project with all features configured
+- Set up the database schema
+- Configure authentication and billing
+- Install all dependencies
+- Prepare your `.env.local` with required environment variables
+
+### 3. Configure Environment Variables
+
+Update the `.env.local` file with your credentials:
+
+```env
+# Database (Supabase)
+DATABASE_URL=your-supabase-connection-string
+
+# Auth (Better Auth)
+BETTER_AUTH_SECRET=your-secret-key
+GOOGLE_CLIENT_ID=your-google-client-id
+GOOGLE_CLIENT_SECRET=your-google-client-secret
+
+# Email (Resend)
+RESEND_API_KEY=your-resend-api-key
+
+# Billing (Polar.sh)
+POLAR_ACCESS_TOKEN=your-polar-access-token
+NEXT_PUBLIC_STARTER_TIER=your-product-id
+NEXT_PUBLIC_STARTER_SLUG=your-product-slug
+```
+
+### 4. Run Your Application
+
+```bash
+cd my-saas-app
+npm run dev
+```
+
+Your SaaS application is now running at `http://localhost:3000`!
+
+## Available Commands
+
+### `shipd login`
+
+Authenticate with your Shipd account via browser-based OAuth flow.
+
+```bash
+npx shipd login
+```
+
+### `shipd logout`
+
+Sign out from your Shipd account.
+
+```bash
+npx shipd logout
+```
+
+### `shipd init [project-name]`
+
+Initialize a new SaaS project with all features configured.
+
+```bash
+npx shipd init my-saas-app
+```
+
+Options:
+- `--mock` - Skip authentication for development/testing purposes
+
+### `shipd list`
+
+List all available features included in the generated project.
+
+```bash
+npx shipd list
+```
+
+### `shipd append`
+
+Add Shipd features to an existing Next.js project.
+
+```bash
+npx shipd append
+```
+
+Options:
+- `--features <features>` - Comma-separated list of features to add (e.g., `docs`)
+- `--dry-run` - Preview changes without applying them
+
+**Available features:**
+- `docs` - Documentation pages with navigation and layout
+
+**Example:**
+```bash
+# Interactive mode
+npx shipd append
+
+# Add specific feature
+npx shipd append --features docs
+
+# Preview changes
+npx shipd append --features docs --dry-run
+```
+
+## What's Included
+
+Every Shipd project includes:
+
+### Pages & Features
+- Landing page with pricing section
+- User authentication (sign up, sign in, password reset)
+- User dashboard with subscription management
+- Billing page with Polar.sh integration
+- Settings page for user profile management
+- Success page after subscription purchase
+
+### Technical Components
+- **Framework**: Next.js 15 with App Router
+- **Language**: TypeScript with strict mode
+- **Styling**: Tailwind CSS with custom design system
+- **Database**: PostgreSQL via Supabase with Drizzle ORM
+- **Auth**: Better Auth with Google OAuth and email authentication
+- **Billing**: Polar.sh for subscription and payment management
+- **Email**: Resend for transactional emails
+- **UI Components**: Shadcn/ui component library
+- **Deployment**: Optimized for Vercel (frontend) and Railway (database)
+
+## Requirements
+
+- Node.js 18.x or higher
+- Active Shipd subscription
+- npm or yarn package manager
+
+## Pricing
+
+Shipd requires an active subscription to generate projects. Visit [shipd.dev](https://www.shipd.dev) to view pricing and subscribe.
+
+## Support
+
+- Documentation: [shipd.dev/docs](https://www.shipd.dev/docs)
+- Issues: [GitHub Issues](https://github.com/kedbrant/Saas-scaffold/issues)
+- Email: support@shipd.com
+
+## License
+
+MIT
+
+## Links
+
+- [Website](https://www.shipd.dev)
+- [GitHub Repository](https://github.com/kedbrant/Saas-scaffold)
+- [Documentation](https://www.shipd.dev/docs)
+
+---
+
+Made with ❤️ by the Shipd team

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node