@doswiftly/cli 0.1.1

package/templates/storefront-nextjs/middleware.ts

@@ -0,0 +1,80 @@
+import { NextResponse } from "next/server";
+import type { NextRequest } from "next/server";
+import {
+  protectedRoutes,
+  guestOnlyRoutes,
+  AUTH_COOKIE_NAME,
+  redirects,
+  matchesRoute,
+} from "@/lib/auth/routes";
+
+/**
+ * Authentication Middleware
+ *
+ * Security Model (3 layers):
+ * 1. Middleware (this file) - Fast redirect based on cookie existence (UX layer)
+ * 2. AuthGuard component - Client-side validation via useAuth hook
+ * 3. GraphQL Backend - Ultimate security (validates token on every request)
+ *
+ * IMPORTANT: This middleware checks cookie EXISTENCE, not VALIDITY.
+ * Token validation happens in:
+ * - AuthGuard (client-side via useAuth hook)
+ * - GraphQL API (server-side, ultimate security)
+ *
+ * Why this approach?
+ * - Middleware runs on Edge Runtime (fast, but limited capabilities)
+ * - Cannot make GraphQL requests to validate token
+ * - Provides instant redirect without waiting for client hydration
+ * - Prevents flash of protected content for unauthenticated users
+ *
+ * @see lib/auth/routes.ts - SSOT for route configuration
+ * @see components/auth/auth-guard.tsx - Client-side auth protection
+ */
+export function middleware(request: NextRequest) {
+  const { pathname } = request.nextUrl;
+  const token = request.cookies.get(AUTH_COOKIE_NAME)?.value;
+  const hasToken = Boolean(token);
+
+  // Protected routes - redirect to login if no token
+  if (matchesRoute(pathname, protectedRoutes)) {
+    if (!hasToken) {
+      const loginUrl = new URL(redirects.unauthenticated, request.url);
+      // Preserve the original URL for redirect after login
+      loginUrl.searchParams.set("redirect", pathname);
+      return NextResponse.redirect(loginUrl);
+    }
+  }
+
+  // Guest-only routes - redirect to account if has token
+  if (matchesRoute(pathname, guestOnlyRoutes)) {
+    if (hasToken) {
+      return NextResponse.redirect(
+        new URL(redirects.authenticated, request.url)
+      );
+    }
+  }
+
+  return NextResponse.next();
+}
+
+/**
+ * Matcher configuration
+ *
+ * Only run middleware on routes that need auth checks.
+ * This improves performance by skipping static assets, API routes, etc.
+ *
+ * Update this when adding new protected or guest-only route groups.
+ */
+export const config = {
+  matcher: [
+    /*
+     * Match all request paths except:
+     * - _next/static (static files)
+     * - _next/image (image optimization files)
+     * - favicon.ico (favicon file)
+     * - public folder files (images, etc.)
+     * - API routes (handled separately)
+     */
+    "/((?!_next/static|_next/image|favicon.ico|.*\\.(?:svg|png|jpg|jpeg|gif|webp)$).*)",
+  ],
+};

package/templates/storefront-nextjs/next.config.ts

@@ -0,0 +1,37 @@
+import type { NextConfig } from 'next';
+
+const nextConfig: NextConfig = {
+  // Enable React strict mode for better development experience
+  reactStrictMode: true,
+
+  // Image optimization configuration
+  images: {
+    remotePatterns: [
+      {
+        protocol: 'https',
+        hostname: '**.doswiftly.pl',
+      },
+      {
+        protocol: 'https',
+        hostname: 'images.unsplash.com',
+      },
+    ],
+  },
+
+  // Experimental features
+  experimental: {
+    // Enable server actions
+    serverActions: {
+      bodySizeLimit: '2mb',
+    },
+  },
+
+  // Environment variables validation
+  env: {
+    NEXT_PUBLIC_API_URL: process.env.NEXT_PUBLIC_API_URL,
+    NEXT_PUBLIC_PROJECT_ID: process.env.NEXT_PUBLIC_PROJECT_ID,
+    NEXT_PUBLIC_SHOP_SLUG: process.env.NEXT_PUBLIC_SHOP_SLUG,
+  },
+};
+
+export default nextConfig;

package/templates/storefront-nextjs/open-next.config.ts

@@ -0,0 +1,3 @@
+import { defineCloudflareConfig } from "@opennextjs/cloudflare";
+
+export default defineCloudflareConfig({});

package/templates/storefront-nextjs/package.dev.json

@@ -0,0 +1,30 @@
+{
+  "name": "test-storefront",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "@doswiftly/commerce-sdk": "file:../../../commerce-sdk",
+    "graphql-request": "^7.1.2",
+    "graphql": "^16.10.0",
+    "next": "latest",
+    "react": "^19",
+    "react-dom": "^19",
+    "lucide-react": "latest"
+  },
+  "devDependencies": {
+    "@types/node": "latest",
+    "@types/react": "latest",
+    "@types/react-dom": "latest",
+    "typescript": "latest",
+    "@tailwindcss/postcss": "latest",
+    "tailwindcss": "latest",
+    "eslint": "latest",
+    "eslint-config-next": "latest"
+  }
+}

package/templates/storefront-nextjs/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "build:cf": "opennextjs-cloudflare build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "@doswiftly/commerce-sdk": "{{SDK_VERSION}}",
+    "graphql-request": "^7.1.2",
+    "graphql": "^16.10.0",
+    "next": "^15.1.9",
+    "react": "^19",
+    "react-dom": "^19",
+    "lucide-react": "latest"
+  },
+  "devDependencies": {
+    "@opennextjs/cloudflare": "^1.0.0",
+    "@types/node": "latest",
+    "@types/react": "latest",
+    "@types/react-dom": "latest",
+    "typescript": "latest",
+    "@tailwindcss/postcss": "latest",
+    "tailwindcss": "latest",
+    "eslint": "latest",
+    "eslint-config-next": "^15.1.9"
+  }
+}

package/templates/storefront-nextjs/package.json.template

@@ -0,0 +1,32 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "@doswiftly/commerce-sdk": "{{SDK_VERSION}}",
+    "@tanstack/react-query": "^5.62.7",
+    "graphql-request": "^7.1.2",
+    "graphql": "^16.10.0",
+    "next": "latest",
+    "react": "^19",
+    "react-dom": "^19",
+    "lucide-react": "latest",
+    "zustand": "^5.0.2"
+  },
+  "devDependencies": {
+    "@types/node": "latest",
+    "@types/react": "latest",
+    "@types/react-dom": "latest",
+    "typescript": "latest",
+    "@tailwindcss/postcss": "latest",
+    "tailwindcss": "latest",
+    "eslint": "latest",
+    "eslint-config-next": "latest"
+  }
+}

package/templates/storefront-nextjs/postcss.config.mjs

@@ -0,0 +1,8 @@
+/** @type {import('postcss-load-config').Config} */
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

package/templates/storefront-nextjs/tailwind.config.ts

@@ -0,0 +1,111 @@
+import type { Config } from 'tailwindcss';
+
+const config: Config = {
+  content: [
+    './pages/**/*.{js,ts,jsx,tsx,mdx}',
+    './components/**/*.{js,ts,jsx,tsx,mdx}',
+    './app/**/*.{js,ts,jsx,tsx,mdx}',
+  ],
+  theme: {
+    extend: {
+      colors: {
+        // Primary brand color - customize for your store
+        primary: {
+          DEFAULT: 'rgb(var(--primary) / <alpha-value>)',
+          foreground: 'rgb(var(--primary-foreground) / <alpha-value>)',
+          50: '#eff6ff',
+          100: '#dbeafe',
+          200: '#bfdbfe',
+          300: '#93c5fd',
+          400: '#60a5fa',
+          500: '#3b82f6',
+          600: '#2563eb',
+          700: '#1d4ed8',
+          800: '#1e40af',
+          900: '#1e3a8a',
+          950: '#172554',
+        },
+        // Secondary color for accents
+        secondary: {
+          DEFAULT: 'rgb(var(--secondary) / <alpha-value>)',
+          foreground: 'rgb(var(--secondary-foreground) / <alpha-value>)',
+        },
+        // Accent color for highlights
+        accent: {
+          DEFAULT: 'rgb(var(--accent) / <alpha-value>)',
+          foreground: 'rgb(var(--accent-foreground) / <alpha-value>)',
+        },
+        // Background and foreground
+        background: 'rgb(var(--background) / <alpha-value>)',
+        foreground: 'rgb(var(--foreground) / <alpha-value>)',
+        // Muted colors for subtle elements
+        muted: {
+          DEFAULT: 'rgb(var(--muted) / <alpha-value>)',
+          foreground: 'rgb(var(--muted-foreground) / <alpha-value>)',
+        },
+        // Border color
+        border: 'rgb(var(--border) / <alpha-value>)',
+        // Ring color for focus states
+        ring: 'rgb(var(--ring) / <alpha-value>)',
+      },
+      borderRadius: {
+        lg: 'var(--radius)',
+        md: 'calc(var(--radius) - 2px)',
+        sm: 'calc(var(--radius) - 4px)',
+      },
+      fontFamily: {
+        sans: ['Inter', 'system-ui', 'sans-serif'],
+      },
+      container: {
+        center: true,
+        padding: {
+          DEFAULT: '1rem',
+          sm: '2rem',
+          lg: '4rem',
+          xl: '5rem',
+          '2xl': '6rem',
+        },
+      },
+      // Commerce-specific spacing
+      spacing: {
+        '18': '4.5rem',
+        '88': '22rem',
+        '128': '32rem',
+      },
+      // Product card aspect ratios
+      aspectRatio: {
+        'product': '4 / 5',
+        'product-wide': '16 / 9',
+        'product-square': '1 / 1',
+      },
+      // Animation for cart and interactions
+      animation: {
+        'slide-in': 'slideIn 0.3s ease-out',
+        'slide-out': 'slideOut 0.3s ease-in',
+        'fade-in': 'fadeIn 0.2s ease-out',
+        'bounce-subtle': 'bounceSubtle 0.5s ease-out',
+      },
+      keyframes: {
+        slideIn: {
+          '0%': { transform: 'translateX(100%)' },
+          '100%': { transform: 'translateX(0)' },
+        },
+        slideOut: {
+          '0%': { transform: 'translateX(0)' },
+          '100%': { transform: 'translateX(100%)' },
+        },
+        fadeIn: {
+          '0%': { opacity: '0' },
+          '100%': { opacity: '1' },
+        },
+        bounceSubtle: {
+          '0%, 100%': { transform: 'scale(1)' },
+          '50%': { transform: 'scale(1.05)' },
+        },
+      },
+    },
+  },
+  plugins: [],
+};
+
+export default config;

package/templates/storefront-nextjs/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/templates/storefront-nextjs/wrangler.toml

@@ -0,0 +1,9 @@
+#:schema node_modules/wrangler/config-schema.json
+
+name = "storefront-template-{{PROJECT_NAME}}"
+main = ".open-next/worker.js"
+compatibility_date = "2024-09-23"
+compatibility_flags = ["nodejs_compat"]
+
+# Assets directory for static files
+assets = { directory = ".open-next/assets", binding = "ASSETS" }

package/templates/storefront-nextjs-shadcn/.env.example

@@ -0,0 +1,68 @@
+# ===========================================
+# DoSwiftly Commerce - Environment Variables
+# ===========================================
+# Copy this file to .env.local and fill in your values
+# Get these values from your DoSwiftly dashboard
+
+# ===========================================
+# Required: API Configuration
+# ===========================================
+
+# DoSwiftly API URL
+# Default: https://api.doswiftly.pl
+# For local development, use your local backend URL
+NEXT_PUBLIC_API_URL={{API_URL}}
+
+# Your Shop Slug (unique identifier)
+# This is the unique identifier for your shop used by the Storefront GraphQL API
+# Find this in your DoSwiftly dashboard under Shop Settings
+# Example: my-awesome-shop
+NEXT_PUBLIC_SHOP_SLUG={{SHOP_SLUG}}
+
+# Storefront Access Token (optional, for private storefronts)
+# Leave empty for public storefront access
+# NEXT_PUBLIC_STOREFRONT_TOKEN=
+
+# ===========================================
+# Optional: Site Configuration
+# ===========================================
+
+# Site URL (used for SEO and social sharing)
+NEXT_PUBLIC_SITE_URL=http://localhost:3000
+
+# Site Name (displayed in browser tab and SEO)
+NEXT_PUBLIC_SITE_NAME={{PROJECT_NAME}}
+
+# ===========================================
+# Optional: Analytics & Tracking
+# ===========================================
+
+# Google Analytics Measurement ID
+# NEXT_PUBLIC_GA_MEASUREMENT_ID=G-XXXXXXXXXX
+
+# Facebook Pixel ID
+# NEXT_PUBLIC_FB_PIXEL_ID=
+
+# ===========================================
+# Optional: Payment Configuration
+# ===========================================
+
+# Stripe Publishable Key (for client-side Stripe.js)
+# NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_...
+
+# PayU POS ID (for PayU integration)
+# NEXT_PUBLIC_PAYU_POS_ID=
+
+# ===========================================
+# Server-side Only (do not prefix with NEXT_PUBLIC_)
+# ===========================================
+
+# DoSwiftly API Key (for server-side operations)
+# Keep this secret! Never expose in client-side code
+# DOSWIFTLY_API_KEY=
+
+# Stripe Secret Key (for server-side Stripe operations)
+# STRIPE_SECRET_KEY=sk_test_...
+
+# Webhook Secret (for verifying webhook signatures)
+# WEBHOOK_SECRET=

package/templates/storefront-nextjs-shadcn/.github/workflows/build-template.yml

@@ -0,0 +1,109 @@
+name: Build & Publish Template
+
+on:
+  push:
+    branches: [main, master]
+    tags: ['v*']
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to publish (e.g., 1.0.0)'
+        required: false
+
+env:
+  # Repository name (e.g., "default1", "minimal", "shadcn")
+  # Worker will be named: storefront-template-{TEMPLATE_NAME}
+  TEMPLATE_NAME: ${{ github.event.repository.name }}
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Normalize template name
+        id: template
+        run: |
+          # Strip "storefront-" prefix if present
+          RAW_NAME="${{ env.TEMPLATE_NAME }}"
+          NORMALIZED="${RAW_NAME#storefront-}"
+          echo "name=${NORMALIZED}" >> $GITHUB_OUTPUT
+          echo "Template name: ${NORMALIZED}"
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Build for Cloudflare (OpenNext)
+        run: npx @opennextjs/cloudflare build
+
+      - name: List build output
+        run: |
+          echo "=== Build output ==="
+          ls -la .open-next/ || echo "No .open-next directory"
+          if [ -f ".open-next/worker.js" ]; then
+            echo "Worker size: $(wc -c < .open-next/worker.js) bytes"
+          fi
+
+      - name: Create deployment wrangler.toml
+        run: |
+          cat > .open-next/wrangler.toml << EOF
+          name = "storefront-template-${{ steps.template.outputs.name }}"
+          main = "worker.js"
+          compatibility_date = "2024-09-23"
+          compatibility_flags = ["nodejs_compat"]
+          assets = { directory = "assets", binding = "ASSETS" }
+          EOF
+
+      - name: Determine version
+        id: version
+        run: |
+          if [ -n "${{ github.event.inputs.version }}" ]; then
+            echo "version=${{ github.event.inputs.version }}" >> $GITHUB_OUTPUT
+          elif [[ "${{ github.ref }}" == refs/tags/v* ]]; then
+            echo "version=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
+          else
+            echo "version=$(jq -r .version package.json)-$(git rev-parse --short HEAD)" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Deploy to Cloudflare Workers
+        working-directory: .open-next
+        env:
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+        run: |
+          if [ -z "$CLOUDFLARE_API_TOKEN" ]; then
+            echo "⏭️ Skipping CF deploy (CLOUDFLARE_API_TOKEN not set)"
+            exit 0
+          fi
+          npx wrangler@latest deploy
+
+      - name: Upload worker bundle artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: worker-bundle
+          path: .open-next/
+          retention-days: 7
+          if-no-files-found: error
+          include-hidden-files: true
+
+      - name: Publish to DoSwiftly (on tag or manual)
+        if: startsWith(github.ref, 'refs/tags/v') || github.event_name == 'workflow_dispatch'
+        env:
+          DOSWIFTLY_TOKEN: ${{ secrets.DOSWIFTLY_DEPLOY_TOKEN }}
+          DOSWIFTLY_API_URL: ${{ secrets.DOSWIFTLY_API_URL }}
+        run: |
+          # Upload bundle to DoSwiftly R2 via API
+          curl -X POST "${DOSWIFTLY_API_URL}/cli/templates/${{ steps.template.outputs.name }}/publish" \
+            -H "Authorization: Bearer ${DOSWIFTLY_TOKEN}" \
+            -F "bundle=@.open-next/worker.js" \
+            -F "version=${{ steps.version.outputs.version }}"

package/templates/storefront-nextjs-shadcn/.github/workflows/deploy.yml

@@ -0,0 +1,25 @@
+name: Deploy Storefront
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    env:
+      NEXT_PUBLIC_API_URL: ${{ secrets.NEXT_PUBLIC_API_URL }}
+      NEXT_PUBLIC_SHOP_SLUG: ${{ secrets.NEXT_PUBLIC_SHOP_SLUG }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+
+      - name: Deploy to DoSwiftly
+        run: npx --yes @doswiftly/cli deploy run --type PRODUCTION
+        env:
+          DOSWIFTLY_DEPLOY_TOKEN: ${{ secrets.DOSWIFTLY_DEPLOY_TOKEN }}

package/templates/storefront-nextjs-shadcn/.github/workflows/preview.yml

@@ -0,0 +1,22 @@
+name: Preview Deployment
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+
+jobs:
+  preview:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      - run: npx doswiftly deploy run --type PREVIEW --branch ${{ github.head_ref }}
+        env:
+          DOSWIFTLY_DEPLOY_TOKEN: ${{ secrets.DOSWIFTLY_DEPLOY_TOKEN }}
+          NEXT_PUBLIC_API_URL: ${{ secrets.NEXT_PUBLIC_API_URL }}
+          NEXT_PUBLIC_SHOP_SLUG: ${{ secrets.NEXT_PUBLIC_SHOP_SLUG }}