@donotdev/cli 0.0.13 → 0.0.15

package/templates/root-consumer/guides/wai-way/spec_template.md.example

@@ -14,6 +14,7 @@
 | **Primary User** | _(Who uses this daily?)_ |
 | **Secondary Users** | _(Who else interacts?)_ |
 | **Core Value** | _(What problem does it solve?)_ |
+| **Aesthetic Essence** | SaaS (Default) / Luxury / Brutalist / Custom |
 
 ---
 
@@ -275,13 +276,13 @@ _(Copy entity template for each entity)_
 
 ---
 
-## 11. Open Questions
+## 11. Design Decisions & Overrides
+> **CRITICAL:** These are intentional deviations from framework UX heuristics (e.g., 3-click rule, 70/30 hierarchy). 
+> **FOR AGENTS:** If a layout choice is documented here, do NOT challenge or flag it during the Build or Polish phases.
 
-> Anything unresolved? List here. **No coding until resolved.**
-
-- [ ]
-- [ ]
-- [ ]
+| Target (Page/Feature) | Override Description | Rationale |
+|-----------------------|----------------------|-----------|
+| | | |
 
 ---
 

package/templates/app-payload/.env.example

@@ -1,28 +0,0 @@
-# Payload CMS Configuration
-PAYLOAD_SECRET=your-super-secret-key-here
-PAYLOAD_PUBLIC_SERVER_URL=http://localhost:3001
-
-# Database Configuration (MongoDB)
-MONGODB_URI=mongodb://localhost:27017/{{projectName}}
-
-# For production, use MongoDB Atlas or similar
-# MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/{{projectName}}?retryWrites=true&w=majority
-
-# Optional: Redis for caching (recommended for production)
-# REDIS_URL=redis://localhost:6379
-
-# CORS Origins (comma-separated)
-CORS_ORIGINS=http://localhost:3000,https://{{projectName}}.com,https://admin.{{projectName}}.com
-
-# File Upload Configuration
-PAYLOAD_PUBLIC_MAX_FILE_SIZE=5000000
-
-# Admin Configuration
-PAYLOAD_PUBLIC_ADMIN_EMAIL=admin@{{projectName}}.com
-PAYLOAD_PUBLIC_ADMIN_PASSWORD=your-admin-password
-
-# Optional: Email Configuration (for notifications)
-# SMTP_HOST=smtp.gmail.com
-# SMTP_PORT=587
-# SMTP_USER=your-email@gmail.com
-# SMTP_PASS=your-app-password 

package/templates/app-payload/README.md.example

@@ -1,233 +0,0 @@
-# {{projectName}} CMS (Payload)
-
-This is a **Payload CMS** application that provides a professional content management system for your business website.
-
-## 🚀 What is Payload CMS?
-
-Payload is a **headless CMS** that gives you:
-- **Database** - Stores all your content (text, images, etc.)
-- **Admin Interface** - Professional web interface for editing content
-- **API** - Your website fetches content via REST API calls
-- **Media Library** - Upload and manage images/files
-
-## 📁 Project Structure
-
-```
-{{appName}}/
-├── collections/           # Content types (Hero, Services, Products, etc.)
-│   ├── Users.ts          # Admin users authentication
-│   ├── Media.ts          # File uploads and media management
-│   ├── Hero.ts           # Landing page hero section
-│   ├── Services.ts       # Business services
-│   ├── Products.ts       # Product offerings
-│   ├── Testimonials.ts   # Client feedback
-│   └── Company.ts        # Company information
-├── src/
-│   └── server.ts         # Express server with Payload
-├── payload.config.ts     # Payload configuration
-├── package.json          # Dependencies and scripts
-└── .env                  # Environment variables
-```
-
-## 🛠️ Content Types
-
-### 1. **Hero Section** (`/admin/collections/hero`)
-- **Title** - Main headline
-- **Subtitle** - Supporting text
-- **CTA Button** - Call-to-action text and link
-- **Background Image** - Hero background
-
-### 2. **Services** (`/admin/collections/services`)
-- **Name** - Service name
-- **Description** - Detailed description
-- **Category** - Consulting, Training, Development, Support
-- **Features** - List of service features
-- **Pricing** - Pricing information
-- **Icon** - Service icon
-
-### 3. **Products** (`/admin/collections/products`)
-- **Name** - Product name
-- **Description** - Product description
-- **Category** - Framework, Tool, Platform, Service
-- **Features** - Key product features
-- **Demo Link** - Live demo URL
-- **Documentation** - Documentation link
-- **GitHub** - Repository link
-
-### 4. **Testimonials** (`/admin/collections/testimonials`)
-- **Client Name** - Client's name
-- **Company** - Company name
-- **Quote** - Testimonial text
-- **Rating** - 1-5 star rating
-- **Avatar** - Client photo
-- **Project** - Related project
-
-### 5. **Company Info** (`/admin/collections/company`)
-- **Name** - Company name
-- **Contact** - Email, phone, address
-- **Social Media** - LinkedIn, Twitter, GitHub, etc.
-- **Logo** - Company logo
-- **Favicon** - Website favicon
-
-## 🚀 Quick Start
-
-### 1. Install Dependencies
-```bash
-bun install
-```
-
-### 2. Set Up Environment
-```bash
-cp .env.example .env
-# Edit .env with your configuration
-```
-
-### 3. Set Up Database
-**Option A: Local MongoDB**
-```bash
-# Install MongoDB locally or use Docker
-docker run -d -p 27017:27017 --name mongodb mongo:latest
-```
-
-**Option B: MongoDB Atlas (Recommended)**
-- Create account at [MongoDB Atlas](https://www.mongodb.com/atlas)
-- Create cluster and get connection string
-- Update `MONGODB_URI` in `.env`
-
-### 4. Start Development Server
-```bash
-bun run dev
-```
-
-### 5. Access Admin Panel
-- **URL**: http://localhost:3001/admin
-- **Email**: admin@{{projectName}}.com
-- **Password**: your-admin-password (from .env)
-
-## 🔗 API Endpoints
-
-### Content API
-- **Hero**: `GET /api/hero`
-- **Services**: `GET /api/services`
-- **Products**: `GET /api/products`
-- **Testimonials**: `GET /api/testimonials`
-- **Company**: `GET /api/company`
-
-### Example API Call
-```javascript
-// Fetch hero content
-const response = await fetch('http://localhost:3001/api/hero');
-const heroData = await response.json();
-console.log(heroData.docs[0]); // Latest hero content
-```
-
-## 🎯 How It Works
-
-### 1. **Content Management**
-- Login to admin panel at `/admin`
-- Edit content using the professional interface
-- Save changes instantly
-
-### 2. **Content Delivery**
-- Your website makes API calls to fetch content
-- Content is returned as JSON
-- Website displays the content dynamically
-
-### 3. **Real-time Updates**
-- Changes in admin appear immediately on website
-- No code deployment needed
-- Non-developers can update content
-
-## 🔧 Configuration
-
-### Environment Variables
-```bash
-# Required
-PAYLOAD_SECRET=your-secret-key
-MONGODB_URI=mongodb://localhost:27017/{{projectName}}
-
-# Optional
-PAYLOAD_PUBLIC_SERVER_URL=http://localhost:3001
-CORS_ORIGINS=http://localhost:3000,https://{{projectName}}.com
-```
-
-### Customization
-- **Add new content types**: Create new files in `collections/`
-- **Modify fields**: Edit field definitions in collection files
-- **Change admin UI**: Customize admin interface in `payload.config.ts`
-
-## 🚀 Deployment
-
-### Vercel Deployment
-1. **Connect to Vercel**
-2. **Set environment variables** in Vercel dashboard
-3. **Deploy** - Vercel will build and deploy automatically
-
-### Environment Variables for Production
-```bash
-PAYLOAD_SECRET=your-production-secret
-MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/{{projectName}}
-PAYLOAD_PUBLIC_SERVER_URL=https://admin.{{projectName}}.com
-CORS_ORIGINS=https://{{projectName}}.com,https://admin.{{projectName}}.com
-```
-
-## 📊 Admin Features
-
-- **User Management** - Create admin users
-- **Media Library** - Upload and organize images
-- **Content Versioning** - Track content changes
-- **Draft/Published** - Preview before publishing
-- **Rich Text Editor** - Format content easily
-- **Image Optimization** - Automatic image resizing
-- **File Upload** - Drag & drop file uploads
-
-## 🔒 Security
-
-- **Authentication** - Secure admin login
-- **CORS Protection** - Configured for your domains
-- **File Upload Limits** - 5MB file size limit
-- **Input Validation** - All inputs validated
-- **HTTPS Required** - Secure in production
-
-## 🎨 Integration with Website
-
-Your website (Next.js/Vite) connects to this CMS:
-
-```typescript
-// Example: Fetch hero content
-const { data: hero } = await fetch('/api/hero').then(r => r.json());
-
-// Example: Fetch services
-const { data: services } = await fetch('/api/services?where[isActive][equals]=true').then(r => r.json());
-
-// Example: Fetch testimonials
-const { data: testimonials } = await fetch('/api/testimonials?sort=order').then(r => r.json());
-```
-
-## 🆘 Troubleshooting
-
-### Common Issues
-
-**"MongoDB connection failed"**
-- Check `MONGODB_URI` in `.env`
-- Ensure MongoDB is running
-- Verify network connectivity
-
-**"Admin panel not loading"**
-- Check `PAYLOAD_SECRET` is set
-- Verify `PAYLOAD_PUBLIC_SERVER_URL` is correct
-- Check browser console for errors
-
-**"API calls failing"**
-- Verify CORS configuration
-- Check server is running on correct port
-- Ensure API endpoints are accessible
-
-### Getting Help
-- Check [Payload Documentation](https://payloadcms.com/docs)
-- Review server logs for error messages
-- Verify environment variables are set correctly
-
----
-
-**That's it!** You now have a professional CMS that your website can use to fetch dynamic content. No more hardcoded text - everything is manageable through the admin interface. 

package/templates/app-payload/collections/Company.ts.example

@@ -1,125 +0,0 @@
-import { CollectionConfig } from 'payload/types';
-
-export const Company: CollectionConfig = {
-  slug: 'company',
-  admin: {
-    useAsTitle: 'name',
-    defaultColumns: ['name', 'email', 'phone', 'updatedAt'],
-  },
-  access: {
-    read: () => true,
-  },
-  fields: [
-    {
-      name: 'name',
-      type: 'text',
-      required: true,
-      admin: {
-        description: 'Company name',
-      },
-    },
-    {
-      name: 'tagline',
-      type: 'text',
-      admin: {
-        description: 'Company tagline or slogan',
-      },
-    },
-    {
-      name: 'description',
-      type: 'textarea',
-      admin: {
-        description: 'Company description for about page',
-      },
-    },
-    {
-      name: 'email',
-      type: 'email',
-      required: true,
-      admin: {
-        description: 'Primary contact email',
-      },
-    },
-    {
-      name: 'phone',
-      type: 'text',
-      admin: {
-        description: 'Contact phone number',
-      },
-    },
-    {
-      name: 'address',
-      type: 'group',
-      fields: [
-        {
-          name: 'street',
-          type: 'text',
-        },
-        {
-          name: 'city',
-          type: 'text',
-        },
-        {
-          name: 'state',
-          type: 'text',
-        },
-        {
-          name: 'zip',
-          type: 'text',
-        },
-        {
-          name: 'country',
-          type: 'text',
-        },
-      ],
-      admin: {
-        description: 'Company address',
-      },
-    },
-    {
-      name: 'social',
-      type: 'group',
-      fields: [
-        {
-          name: 'website',
-          type: 'text',
-        },
-        {
-          name: 'linkedin',
-          type: 'text',
-        },
-        {
-          name: 'twitter',
-          type: 'text',
-        },
-        {
-          name: 'github',
-          type: 'text',
-        },
-        {
-          name: 'youtube',
-          type: 'text',
-        },
-      ],
-      admin: {
-        description: 'Social media links',
-      },
-    },
-    {
-      name: 'logo',
-      type: 'upload',
-      relationTo: 'media',
-      admin: {
-        description: 'Company logo',
-      },
-    },
-    {
-      name: 'favicon',
-      type: 'upload',
-      relationTo: 'media',
-      admin: {
-        description: 'Website favicon',
-      },
-    },
-  ],
-}; 

package/templates/app-payload/collections/Hero.ts.example

@@ -1,62 +0,0 @@
-import { CollectionConfig } from 'payload/types';
-
-export const Hero: CollectionConfig = {
-  slug: 'hero',
-  admin: {
-    useAsTitle: 'title',
-    defaultColumns: ['title', 'subtitle', 'updatedAt'],
-  },
-  access: {
-    read: () => true,
-  },
-  fields: [
-    {
-      name: 'title',
-      type: 'text',
-      required: true,
-      admin: {
-        description: 'Main headline for the hero section',
-      },
-    },
-    {
-      name: 'subtitle',
-      type: 'textarea',
-      required: true,
-      admin: {
-        description: 'Supporting text below the main headline',
-      },
-    },
-    {
-      name: 'ctaText',
-      type: 'text',
-      required: true,
-      admin: {
-        description: 'Call-to-action button text',
-      },
-    },
-    {
-      name: 'ctaLink',
-      type: 'text',
-      required: true,
-      admin: {
-        description: 'Where the CTA button should link to',
-      },
-    },
-    {
-      name: 'backgroundImage',
-      type: 'upload',
-      relationTo: 'media',
-      admin: {
-        description: 'Background image for the hero section',
-      },
-    },
-    {
-      name: 'isActive',
-      type: 'checkbox',
-      defaultValue: true,
-      admin: {
-        description: 'Whether this hero content should be displayed',
-      },
-    },
-  ],
-}; 

package/templates/app-payload/collections/Media.ts.example

@@ -1,41 +0,0 @@
-import { CollectionConfig } from 'payload/types';
-
-export const Media: CollectionConfig = {
-  slug: 'media',
-  upload: {
-    staticDir: '../public/media',
-    imageSizes: [
-      {
-        name: 'thumbnail',
-        width: 400,
-        height: 300,
-        position: 'centre',
-      },
-      {
-        name: 'card',
-        width: 768,
-        height: 1024,
-        position: 'centre',
-      },
-      {
-        name: 'hero',
-        width: 1920,
-        height: 1080,
-        position: 'centre',
-      },
-    ],
-    adminThumbnail: 'thumbnail',
-    mimeTypes: ['image/*'],
-  },
-  fields: [
-    {
-      name: 'alt',
-      type: 'text',
-      required: true,
-    },
-    {
-      name: 'caption',
-      type: 'text',
-    },
-  ],
-}; 

package/templates/app-payload/collections/Products.ts.example

@@ -1,115 +0,0 @@
-import { CollectionConfig } from 'payload/types';
-
-export const Products: CollectionConfig = {
-  slug: 'products',
-  admin: {
-    useAsTitle: 'name',
-    defaultColumns: ['name', 'category', 'isActive', 'updatedAt'],
-  },
-  access: {
-    read: () => true,
-  },
-  fields: [
-    {
-      name: 'name',
-      type: 'text',
-      required: true,
-      admin: {
-        description: 'Name of the product',
-      },
-    },
-    {
-      name: 'description',
-      type: 'textarea',
-      required: true,
-      admin: {
-        description: 'Detailed description of the product',
-      },
-    },
-    {
-      name: 'shortDescription',
-      type: 'text',
-      required: true,
-      admin: {
-        description: 'Brief description for cards and previews',
-      },
-    },
-    {
-      name: 'category',
-      type: 'select',
-      required: true,
-      options: [
-        { label: 'Framework', value: 'framework' },
-        { label: 'Tool', value: 'tool' },
-        { label: 'Platform', value: 'platform' },
-        { label: 'Service', value: 'service' },
-      ],
-      admin: {
-        description: 'Category of the product',
-      },
-    },
-    {
-      name: 'features',
-      type: 'array',
-      fields: [
-        {
-          name: 'feature',
-          type: 'text',
-          required: true,
-        },
-        {
-          name: 'description',
-          type: 'text',
-        },
-      ],
-      admin: {
-        description: 'List of key features',
-      },
-    },
-    {
-      name: 'demoLink',
-      type: 'text',
-      admin: {
-        description: 'Link path live demo',
-      },
-    },
-    {
-      name: 'documentationLink',
-      type: 'text',
-      admin: {
-        description: 'Link path documentation',
-      },
-    },
-    {
-      name: 'githubLink',
-      type: 'text',
-      admin: {
-        description: 'Link path GitHub repository',
-      },
-    },
-    {
-      name: 'image',
-      type: 'upload',
-      relationTo: 'media',
-      admin: {
-        description: 'Product image or logo',
-      },
-    },
-    {
-      name: 'isActive',
-      type: 'checkbox',
-      defaultValue: true,
-      admin: {
-        description: 'Whether this product should be displayed',
-      },
-    },
-    {
-      name: 'order',
-      type: 'number',
-      defaultValue: 0,
-      admin: {
-        description: 'Display order (lower numbers appear first)',
-      },
-    },
-  ],
-};