@digilogiclabs/create-saas-app 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @digilogiclabs/create-saas-app
+
+## 1.1.0
+
+### Minor Changes
+
+- init

package/README.md

@@ -0,0 +1,472 @@
+# @digilogiclabs/create-saas-app
+
+Create modern SaaS applications with DigitalLogic Labs packages in seconds. This CLI tool generates production-ready web and mobile applications with authentication, theming, and best practices built-in.
+
+## 🚀 Quick Start
+
+```bash
+# Create a web SaaS application
+npx @digilogiclabs/create-saas-app web saas my-startup
+
+# Create a mobile app with tab navigation
+npx @digilogiclabs/create-saas-app mobile tabs my-mobile-app
+
+# Create both web and mobile apps
+npx @digilogiclabs/create-saas-app both base my-full-stack-app
+```
+
+## 📦 Installation
+
+### Using npx (Recommended)
+```bash
+npx @digilogiclabs/create-saas-app
+```
+
+### Global Installation
+```bash
+npm install -g @digilogiclabs/create-saas-app
+create-saas-app --help
+```
+
+## 🎯 Features
+
+- 🚀 **Rapid Development**: From idea to running app in under 5 minutes
+- 🎯 **Platform Flexibility**: Web (Next.js), Mobile (Expo), or both
+- 🔧 **Smart Configuration**: Auto-configures auth, database, and themes
+- 📦 **Package Integration**: Pre-configured with DigitalLogic Labs packages
+- 🎨 **Multiple Themes**: Corporate, startup, or default styling
+- 🔐 **Auth Ready**: Firebase or Supabase authentication
+- 📊 **Database Ready**: Supabase or Firebase database setup
+- 🚀 **Deploy Ready**: Vercel, Netlify, and Expo deployment configs
+- 📱 **Responsive Design**: Mobile-first approach for web apps
+- 🌙 **Dark Mode**: Built-in theme switching
+- 📦 **TypeScript**: Type-safe development
+- 🎯 **ESLint & Prettier**: Code quality tools
+
+## 🌐 Web Applications
+
+### Available Web Templates
+
+#### **Base Template**
+Clean Next.js starter with authentication and UI components
+```bash
+npx @digilogiclabs/create-saas-app web base my-web-app
+```
+
+#### **Dashboard Template**
+Admin dashboard with analytics and user management
+```bash
+npx @digilogiclabs/create-saas-app web dashboard admin-panel
+```
+
+#### **SaaS Template**
+Multi-tenant SaaS application with billing and teams
+```bash
+npx @digilogiclabs/create-saas-app web saas my-saas-platform
+```
+
+### Web Project Structure
+```
+my-web-app/
+├── src/
+│   ├── app/                 # Next.js App Router
+│   │   ├── globals.css     # Global styles with Tailwind
+│   │   ├── layout.tsx      # Root layout with providers
+│   │   └── page.tsx        # Home page component
+│   ├── components/         # Reusable React components
+│   │   ├── auth/          # Authentication components
+│   │   ├── layout/        # Layout components (header, footer)
+│   │   ├── ui/            # UI components (buttons, cards, etc.)
+│   │   └── providers/     # Context providers
+│   ├── lib/               # Utility libraries
+│   │   └── utils.ts       # Helper functions
+│   ├── hooks/             # Custom React hooks
+│   └── types/             # TypeScript type definitions
+├── public/                # Static assets
+├── .env.example          # Environment variables template
+├── tailwind.config.js    # Tailwind CSS configuration
+├── next.config.js        # Next.js configuration
+└── package.json          # Dependencies and scripts
+```
+
+### Getting Started with Web Apps
+
+1. **Create your project**:
+   ```bash
+   npx @digilogiclabs/create-saas-app web base my-web-app
+   cd my-web-app
+   ```
+
+2. **Configure environment variables**:
+   ```bash
+   cp .env.example .env.local
+   # Edit .env.local with your configuration
+   ```
+
+3. **Start development server**:
+   ```bash
+   npm run dev
+   ```
+
+4. **Open in browser**: http://localhost:3000
+
+### Web Environment Variables
+```bash
+# App Configuration
+NEXT_PUBLIC_APP_NAME=my-web-app
+NEXT_PUBLIC_APP_URL=http://localhost:3000
+
+# Firebase (if selected)
+NEXT_PUBLIC_FIREBASE_API_KEY=your_api_key
+NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com
+NEXT_PUBLIC_FIREBASE_PROJECT_ID=your_project_id
+
+# Supabase (if selected)
+NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
+NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
+```
+
+## 📱 Mobile Applications
+
+### Available Mobile Templates
+
+#### **Base Template**
+Simple Expo app with navigation and authentication
+```bash
+npx @digilogiclabs/create-saas-app mobile base my-mobile-app
+```
+
+#### **Tabs Template**
+Tab-based navigation structure
+```bash
+npx @digilogiclabs/create-saas-app mobile tabs my-tabs-app
+```
+
+#### **Stack Template**
+Stack-based navigation structure
+```bash
+npx @digilogiclabs/create-saas-app mobile stack my-stack-app
+```
+
+### Mobile Project Structure
+```
+my-mobile-app/
+├── src/
+│   ├── navigation/        # React Navigation setup
+│   ├── screens/          # Screen components
+│   │   ├── auth/         # Authentication screens
+│   │   └── main/         # Main app screens
+│   ├── components/       # Reusable components
+│   │   ├── auth/         # Auth-related components
+│   │   ├── layout/       # Layout components
+│   │   └── ui/           # UI components
+│   ├── providers/        # Context providers
+│   ├── hooks/            # Custom hooks
+│   ├── services/         # API and external services
+│   ├── utils/            # Utility functions
+│   └── types/            # TypeScript definitions
+├── assets/               # Images, icons, fonts
+├── App.tsx              # Root component
+├── app.json             # Expo configuration
+└── package.json         # Dependencies and scripts
+```
+
+### Getting Started with Mobile Apps
+
+1. **Create your project**:
+   ```bash
+   npx @digilogiclabs/create-saas-app mobile base my-mobile-app
+   cd my-mobile-app
+   ```
+
+2. **Install dependencies**:
+   ```bash
+   npm install
+   ```
+
+3. **Start Expo development server**:
+   ```bash
+   npm start
+   # or
+   npx expo start
+   ```
+
+4. **Run on device/simulator**:
+   - **iOS**: `npm run ios` or scan QR code with Camera app
+   - **Android**: `npm run android` or scan QR code with Expo Go app
+   - **Web**: `npm run web`
+
+### Mobile Development Requirements
+
+- **Node.js**: 16.0.0 or higher
+- **Expo CLI**: `npm install -g @expo/cli`
+- **iOS Development**: Xcode (macOS only)
+- **Android Development**: Android Studio
+- **Physical Device**: Expo Go app for testing
+
+## 🔧 Command Line Interface
+
+### Interactive Mode
+```bash
+npx @digilogiclabs/create-saas-app
+```
+The CLI will guide you through project configuration with interactive prompts.
+
+### Command Line Options
+```bash
+npx @digilogiclabs/create-saas-app <platform> [template] [name] [options]
+
+Arguments:
+  platform              Platform: web, mobile, or both
+  template              Template type (optional)
+  name                  Project name (optional)
+
+Options:
+  -a, --auth <provider>      Auth provider: firebase, supabase
+  -d, --database <provider>  Database provider: supabase, firebase
+  -t, --theme <theme>        Theme: default, corporate, startup
+  --no-install              Skip package installation
+  --no-git                  Skip git initialization
+  -y, --yes                 Skip interactive prompts
+  -h, --help                Display help for command
+```
+
+### Usage Examples
+
+#### Web Applications
+```bash
+# Basic web app with defaults
+npx @digilogiclabs/create-saas-app web base my-app
+
+# SaaS app with Supabase and corporate theme
+npx @digilogiclabs/create-saas-app web saas my-startup \
+  --auth=supabase --database=supabase --theme=corporate
+
+# Dashboard with Firebase auth
+npx @digilogiclabs/create-saas-app web dashboard admin-panel \
+  --auth=firebase --database=firebase
+
+# Skip installation and git init
+npx @digilogiclabs/create-saas-app web base my-app \
+  --no-install --no-git
+```
+
+#### Mobile Applications
+```bash
+# Basic mobile app
+npx @digilogiclabs/create-saas-app mobile base my-mobile-app
+
+# Tab navigation with Firebase
+npx @digilogiclabs/create-saas-app mobile tabs my-tabs-app \
+  --auth=firebase
+
+# Stack navigation with Supabase
+npx @digilogiclabs/create-saas-app mobile stack my-stack-app \
+  --auth=supabase --database=supabase
+```
+
+#### Full-Stack Applications
+```bash
+# Create both web and mobile
+npx @digilogiclabs/create-saas-app both base my-full-stack-app
+
+# With specific configuration
+npx @digilogiclabs/create-saas-app both base my-platform \
+  --auth=supabase --database=supabase --theme=startup
+```
+
+## 🎨 Themes
+
+### Default Theme
+Clean and modern design with neutral colors
+```bash
+--theme=default
+```
+
+### Corporate Theme
+Professional business theme with blue accents
+```bash
+--theme=corporate
+```
+
+### Startup Theme
+Bold and innovative design with purple accents
+```bash
+--theme=startup
+```
+
+## 🔐 Authentication Setup
+
+### Firebase Authentication
+
+1. **Create Firebase Project**: https://console.firebase.google.com
+2. **Enable Authentication**: Go to Authentication > Sign-in method
+3. **Get Configuration**: Project Settings > General > Your apps
+4. **Update Environment Variables**:
+   ```bash
+   NEXT_PUBLIC_FIREBASE_API_KEY=your_api_key
+   NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com
+   NEXT_PUBLIC_FIREBASE_PROJECT_ID=your_project_id
+   ```
+
+### Supabase Authentication
+
+1. **Create Supabase Project**: https://supabase.com/dashboard
+2. **Get API Keys**: Settings > API
+3. **Update Environment Variables**:
+   ```bash
+   NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
+   NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
+   ```
+
+## 🚀 Deployment
+
+### Web Deployment
+
+#### Vercel (Recommended)
+```bash
+npm install -g vercel
+vercel
+```
+
+#### Netlify
+```bash
+npm run build
+# Upload dist folder to Netlify
+```
+
+### Mobile Deployment
+
+#### Expo Application Services (EAS)
+```bash
+npm install -g eas-cli
+eas build
+eas submit
+```
+
+#### Manual Build
+```bash
+# iOS
+npx expo run:ios --configuration Release
+
+# Android
+npx expo run:android --variant release
+```
+
+## 🛠️ Adding Features
+
+Add features to existing projects:
+
+```bash
+# Add billing to your SaaS app
+npx @digilogiclabs/create-saas-app add billing --provider=stripe
+
+# Add analytics
+npx @digilogiclabs/create-saas-app add analytics --provider=mixpanel
+
+# Add team management
+npx @digilogiclabs/create-saas-app add teams
+```
+
+## 🔄 Updating Dependencies
+
+Keep your DigitalLogic Labs packages up to date:
+
+```bash
+# Check for updates
+npx @digilogiclabs/create-saas-app update --check
+
+# Update all packages
+npx @digilogiclabs/create-saas-app update
+```
+
+## 📋 Requirements
+
+- **Node.js**: 16.0.0 or higher
+- **Package Manager**: npm, yarn, or pnpm
+- **Git**: For repository initialization
+- **Expo CLI**: For mobile development (`npm install -g @expo/cli`)
+
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+### Development Setup
+
+1. **Clone the repository**:
+   ```bash
+   git clone https://github.com/DigiLogicLabs/create-saas-app.git
+   cd create-saas-app
+   ```
+
+2. **Install dependencies**:
+   ```bash
+   npm install
+   ```
+
+3. **Build the CLI**:
+   ```bash
+   npm run build
+   ```
+
+4. **Test locally**:
+   ```bash
+   node dist/cli/index.js create web base test-app
+   ```
+
+## 📚 Documentation
+
+- [Getting Started Guide](./docs/getting-started.md)
+- [Web Templates](./docs/templates/web-templates.md)
+- [Mobile Templates](./docs/templates/mobile-templates.md)
+- [Authentication Setup](./docs/auth-setup.md)
+- [Theming Guide](./docs/theming.md)
+- [Deployment Guide](./docs/deployment.md)
+
+## 🐛 Troubleshooting
+
+### Common Issues
+
+#### "Command not found" error
+```bash
+# Make sure you're using npx
+npx @digilogiclabs/create-saas-app
+
+# Or install globally
+npm install -g @digilogiclabs/create-saas-app
+```
+
+#### Template generation fails
+```bash
+# Check Node.js version
+node --version  # Should be 16.0.0+
+
+# Clear npm cache
+npm cache clean --force
+```
+
+#### Mobile app won't start
+```bash
+# Install Expo CLI
+npm install -g @expo/cli
+
+# Clear Expo cache
+npx expo start --clear
+```
+
+## 📄 License
+
+MIT © DigitalLogic Labs
+
+## 🆘 Support
+
+- 📧 **Email**: support@digilogiclabs.com
+- 💬 **Discord**: [Join our community](https://discord.gg/digilogiclabs)
+- 📖 **Documentation**: [docs.digilogiclabs.com](https://docs.digilogiclabs.com)
+- 🐛 **Issues**: [GitHub Issues](https://github.com/DigiLogicLabs/create-saas-app/issues)
+- 💡 **Feature Requests**: [GitHub Discussions](https://github.com/DigiLogicLabs/create-saas-app/discussions)
+
+---
+
+**Built with ❤️ by DigitalLogic Labs**
+

package/bin/index.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+require('../dist/cli/index.js');
+

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { Command } from 'commander';
+
+declare const program: Command;
+
+export { program as default };