Skip to content

Kasimkkn/website-builder

Repository files navigation

AI Website Builder Development Prompt

Project Overview

Build a comprehensive website builder tool targeting both technical and non-technical users. The system should use JSON for data management initially (frontend-only), with plans for backend integration later. The core value proposition is delivering complete, production-ready React projects with perfect folder structure that work immediately after npm install && npm run dev.

Core Functionality Requirements

1. Dynamic Content Customization

  • Enable full customization of all content elements (images, videos, text, titles, paragraphs, buttons, icons any other editable content)
  • Provide dual customization approach:
    • Manual Tailwind CSS input for advanced users ✅
    • Visual option selection for non-technical users ✅
  • Ensure all customizations are properly applied and exportable

2. Dynamic Page Management

  • Allow unlimited page creation and deletion ✅
  • Default pages: Home, About, Service, Contact ✅
  • Each page should be fully customizable and manageable ✅
  • Implement proper routing structure for all pages ❓❓

3. Component Library System

  • Create extensive library of pre-built components with multiple variants: ✅
    • Navigation bars (multiple designs) ✅
    • Hero sections (various layouts) ✅
    • Service sections (different styles) ✅
    • Feature sections (different styles) ✅
    • Contact sections (different styles) ✅
    • Footer components (multiple options) ✅
    • Additional UI components as needed ❓❓
  • Each component category should offer diverse design options ✅
  • Components must be easily selectable and swappable ✅

4. Section Reordering

  • Implement intuitive drag-and-drop interface for section reordering ✅
  • Maintain component integrity during reordering ✅
  • Provide visual feedback during drag operations ✅

5. Theme Customization

  • Complete theme control via Tailwind CSS ✅
  • Color picker integration for easy theme updates ✅
  • Theme changes should apply globally while respecting component-specific customizations ❓❓

6. Template System

  • Provide pre-designed templates as starting points ✅
  • Allow complete template customization after selection ❓❓
  • Template selection should not lock users into rigid structures ✅

7. Content Management

  • All content changes should be stored within respective components
  • Maintain content persistence across sessions
  • Enable inline editing for text content

8. Code Export System

  • Generate complete, organized React project structure ✅
  • Include all necessary dependencies and configurations ✅
  • Ensure exported project includes: ✅
    • Proper React Router DOM setup ✅
    • All selected and customized components ✅
    • Complete page structure ✅
    • Tailwind CSS configuration ✅
    • Package.json with all dependencies ✅
  • Export as downloadable ZIP file ✅
  • Critical: Exported project must work perfectly with just npm install && npm run dev

User Management & Analytics

9. User Activity Tracking

  • Track project creation, exports, and content modifications
  • Monitor most-used components for insights
  • Store user preferences and project history

10. Credit System

  • Initialize users with 3 free credits
  • Deduct 1 credit per project export/download
  • Implement credit purchase system ($3 per credit)
  • Provide clear credit balance visibility

Enhanced User Experience Features

11. Live Preview Mode

  • Real-time preview updates without page refresh ✅
  • Instant visual feedback for all changes ✅
  • Seamless editing experience ✅

12. Responsive Design Testing

  • Built-in device view switcher (mobile, tablet, desktop)
  • Real-time responsiveness testing
  • Ensure all components work across all screen sizes

13. Undo/Redo Functionality

  • Comprehensive action history tracking
  • Support for content changes, component swaps, and structural modifications
  • Intuitive keyboard shortcuts (Ctrl+Z, Ctrl+Y)

14. Save System

  • Automatic background saving
  • Manual save option for user control ✅
  • Visual save status indicators

15. Drag and Drop Interface

  • Intuitive component placement and reordering ✅
  • Visual drop zones and feedback
  • Smooth animations and transitions

16. Component Discovery

  • Search functionality for component library
  • Category-based filtering
  • Clear component previews and descriptions

17. Editor Interface Modes

  • Dark/Light mode toggle for editor UI
  • User preference persistence
  • Comfortable editing environment

18. SEO Management

  • Meta title and description editing per page
  • Custom favicon upload and management
  • Basic SEO optimization tools

19. Advanced Page Settings

  • Custom script integration (Google Analytics, etc.)
  • Individual page meta tag management
  • URL slug customization
  • Page-specific configurations

Technical Implementation Standards

Responsive Design

  • Ensure pixel-perfect responsiveness across all devices
  • Test thoroughly on desktop, tablet, and mobile viewports
  • Use appropriate Tailwind CSS responsive utilities

Form Handling & Validation

  • Implement real-time inline validations
  • Provide clear error messaging and user guidance
  • Use proper input types and accessibility features
  • Include auto-complete and focus management
  • Optimize for performance and usability

Edge Case Management

Handle all potential edge cases gracefully:

  • Empty states with helpful messaging
  • Broken or missing images with fallbacks
  • Unauthorized access scenarios
  • Loading states for all operations
  • Error states for failed operations
  • Form submission failures with recovery options

Code Quality Standards

  • Write clean, readable code without inline comments
  • Use descriptive variable and function names
  • Build reusable, decoupled UI components
  • Implement proper prop typing (TypeScript preferred)
  • Maintain clear separation of concerns
  • Ensure component reusability across the application

Documentation Requirements

  • Maintain comprehensive README.md with:
    • Clear setup instructions
    • Technology stack overview
    • Available scripts and commands
    • Deployment guidelines
  • Write JSDoc/TSDoc for public utilities and services
  • Document complex logic and business rules

Target Audience Considerations

  • Technical Users: Provide advanced customization options, code access, and detailed controls
  • Non-Technical Users: Offer intuitive visual interfaces, guided workflows, and simplified options
  • Universal Features: Ensure all functionality is accessible regardless of technical expertise

Success Criteria

The project succeeds when:

  1. Exported projects work immediately after npm install && npm run dev
  2. Both technical and non-technical users can create professional websites
  3. All customizations are properly preserved and functional
  4. The interface is intuitive and responsive across all devices
  5. The component library provides sufficient variety for diverse needs
  6. The credit system operates smoothly and transparently

Themes to be used:

  • bg-[#1c1c1c] for background
  • bg-[#272725] for accents
  • text-white for texts
  • Dynamic Array/Object Input Handling: ✅ [need to test it again for each component array ] When an element is selected in a component and its type is an array or object, we want to dynamically render inputs based on the array.length, prefilled with the existing data. Users should be able to add, update, or delete any item in that array/object directly through the UI.

-- still the image or video is not been renderend in the live preivew of the component

  • in advnaced mode, the tailwindCss or customCss is not been applied correct to that element

  • saari fucntuonality ko test kro hr 1 element ko update kr skey uska content uski styles everything

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages