diff --git a/apps/landing/src/app/(apps)/docs/guides/placeholder-images/page.tsx b/apps/landing/src/app/(apps)/docs/guides/placeholder-images/page.tsx index fead8d0..2bf2847 100644 --- a/apps/landing/src/app/(apps)/docs/guides/placeholder-images/page.tsx +++ b/apps/landing/src/app/(apps)/docs/guides/placeholder-images/page.tsx @@ -24,15 +24,11 @@ const articleSchema = createTechArticleSchema(PAGE); const tocItems = [ { id: 'what-this-guide-covers', text: 'What This Guide Covers', level: 2 }, - { id: 'ai-generation-basics', text: 'AI Generation Basics', level: 2 }, + { id: 'how-to-create-placeholders', text: 'How to Create Placeholders', level: 2 }, { id: 'quick-start', text: 'Quick Start', level: 2 }, { id: 'organizing-placeholders', text: 'Organizing Placeholders', level: 2 }, { id: 'prompt-tips', text: 'Prompt Tips', level: 2 }, - { id: 'avatar-placeholder', text: 'Avatar Placeholder', level: 2 }, - { id: 'product-image', text: 'Product Image', level: 2 }, - { id: 'hero-section', text: 'Hero Section', level: 2 }, - { id: 'og-image', text: 'OG Image', level: 2 }, - { id: 'features-block', text: 'Features Block', level: 2 }, + { id: 'recipes', text: 'Recipes', level: 2 }, { id: 'file-based-workflow', text: 'File-based Workflow', level: 2 }, ]; @@ -67,7 +63,7 @@ export default function PlaceholderImagesGuidePage() { > {/* What This Guide Covers */} @@ -76,59 +72,39 @@ export default function PlaceholderImagesGuidePage() { What This Guide Covers

- This guide shows how to generate placeholder images with Banatie: + Two ways to generate placeholder images with Banatie:

- All examples use real Live URLs. Images you see on this page are generated by Banatie. + All examples on this page use real placeholder image URLs generated by Banatie.

- {/* AI Generation Basics */} -
- - AI Generation Basics + {/* How to Create Placeholders */} +
+ + How to Create Placeholders -

- Banatie generates images from text descriptions. Key concepts: -

-
-

Prompt → Image

-

- Describe what you need. The AI generates a matching image. -

-
- -
-

Prompt Enhancement

-

- Short prompts are automatically expanded. "office" becomes a detailed - description with lighting, composition, and style. -

-
-

Templates

- Control visual style with the template parameter: + Choose a style, get quality results. Banatie enhances your simple prompt based on + the selected template:

  • - photorealistic — photo-like images + photorealistic — photo-quality images
  • digital-art — stylized illustrations @@ -137,13 +113,30 @@ export default function PlaceholderImagesGuidePage() { 3d-render — 3D graphics
+

+ + View all templates → + +

-

Caching

-

- Same prompt returns the same image. First request generates, subsequent requests - serve from cache instantly. +

Simple Prompts

+

+ Write minimal descriptions. Templates handle the rest: +

+
    +
  • + "office" becomes a detailed + modern office with proper lighting +
  • +
  • + "headshot" becomes a + professional portrait with studio background +
  • +
+

+ No need for complex prompts — this is for placeholders, not art.

@@ -154,23 +147,38 @@ export default function PlaceholderImagesGuidePage() { Quick Start -

Basic Live URL format:

+

+ Live URLs let you generate images by describing what you need right in the URL. No API + calls, no file management — just an HTML placeholder image tag with your prompt. Each + unique prompt is cached, so subsequent loads are instant via CDN. +

+ +

Basic URL format:

-

Minimal example:

+

Example:

`} language="html" - filename="Basic Usage" + filename="HTML Placeholder Image" /> +

Result:

+ + Mountain landscape + +

Parameters:

Organizing Placeholders -

Use scopes to group related images:

+

+ Organize images by sections of your site using scopes: +

- Scopes are created automatically on first use. Each scope maintains its own cache. For - scope configuration and limits, see{' '} + Learn more about scopes in{' '} - Live URLs → Scopes + Live URLs documentation .

@@ -227,34 +234,25 @@ export default function PlaceholderImagesGuidePage() {
-

Be specific

- -
- -
-

Dark mode

-

Include theme context in your prompt:

- -
- -
-

Consistent style

+

Write less, not more

- Use the template parameter for visual consistency across - multiple images: + For placeholders, simple prompts work best. Templates add the details:

+
    +
  • Want an office? Write "office"
  • +
  • + Need something specific? Add only what matters: "office dark theme" +
  • +
+
+ +
+

Colors and themes

+

Control the mood with color hints:

@@ -262,135 +260,121 @@ export default function PlaceholderImagesGuidePage() {
- All examples in this guide use prompt enhancement. Your short descriptions are - automatically expanded into detailed prompts. + Templates automatically enhance your prompts. A simple description becomes a detailed + generation instruction.
- {/* Avatar Placeholder */} -
- - Avatar Placeholder + {/* Recipes */} +
+ + Recipes -

- Aspect ratio: 1:1 -

-

- Use case: User profiles, team sections, - testimonials. +

+ Copy-paste examples for common placeholder image use cases.

- - Testimonial Card - - -
-
- Sarah Chen -
-

- “Banatie cut our design mockup time in half. No more hunting for stock - photos.” -

-

Sarah Chen

-

Product Designer at Acme

+ {/* Avatar */} +
+

Avatar

+

+ 1:1 · User profiles, team sections, testimonials +

+ + +
+
+ Sarah Chen +
+

+ Banatie cut our design mockup time in half. No more hunting for stock photos. +

+

Sarah Chen

+

Product Designer at Acme

+
-
- + -
`} language="html" - filename="Avatar Code" /> + +
+

Team grid example:

+ +
+
+ Alex Rivera +
+

Alex Rivera

+

Engineering Lead

+
+
+
+ Maria Santos +
+

Maria Santos

+

Design Director

+
+
+
+ James Wilson +
+

James Wilson

+

Product Manager

+
+
+
+
+
- - Team Grid - - -
-
- Alex Rivera -
-

Alex Rivera

-

Engineering Lead

-
-
-
- Maria Santos -
-

Maria Santos

-

Design Director

-
-
-
- James Wilson -
-

James Wilson

-

Product Manager

-
-
-
-
-
+ {/* Product */} +
+

Product

+

+ 1:1 or 4:5 · E-commerce, catalogs, + listings +

- {/* Product Image */} -
- - Product Image - -

- Aspect ratio: 1:1{' '} - (square) or 4:5 (portrait) -

-

- Use case: E-commerce catalogs, product cards, - listings. -

+ +
+ Wireless Pro Headphones +

Wireless Pro Headphones

+

$299

+ +
+
- - Product Card - - -
- Wireless Pro Headphones -

Wireless Pro Headphones

-

$299

- -
-
- -
`} language="html" - filename="Product Image Code" /> + +
+

Product grid example:

+ +
+
+ Smart Watch X1 +

Smart Watch X1

+

$199

+
+
+ AirPods Pro +

AirPods Pro

+

$249

+
+
+ Portable Speaker +

Portable Speaker

+

$79

+
+
+ Laptop Stand +

Laptop Stand

+

$129

+
+
+
+
- - Product Grid - - -
-
- Smart Watch X1 -

Smart Watch X1

-

$199

-
-
- AirPods Pro -

AirPods Pro

-

$249

-
-
- Portable Speaker -

Portable Speaker

-

$79

-
-
- Laptop Stand -

Laptop Stand

-

$129

-
-
-
-
+ {/* Hero */} +
+

Hero

+

+ 16:9 · Landing pages, section backgrounds +

- {/* Hero Section */} -
- - Hero Section - -

- Aspect ratio: 16:9 -

-

- Use case: Landing page heroes, section - backgrounds, feature highlights. -

- - -
- Hero background -
-

Build the Future

-

- Start your next project with AI-powered tools -

+ +
+ Hero background +
+

Build the Future

+

Start your next project with AI-powered tools

+
-
- + -
+ code={`
Hero background
`} language="html" - filename="Hero Section Code" />
-
- {/* OG Image */} -
- - OG Image - -

- Aspect ratio: 1200:630{' '} - (standard for social media) -

-

- Use case: Social sharing previews, - Twitter/LinkedIn cards. -

+ {/* OG Image */} +
+

OG Image

+

+ 1200:630 · Social sharing, Twitter/LinkedIn cards +

- -
-
-
- - - + +
+
+
+ + + +
+ twitter.com +
+
+ OG Image Preview +

banatie.app

+

+ AI Placeholder Images Guide | Banatie +

+

+ Generate AI placeholder images for development... +

- twitter.com
-
- OG Image Preview -

banatie.app

-

AI Placeholder Images Guide | Banatie

-

- Generate AI placeholder images for development... -

-
-
- + -
- - - - -`} + code={` + +`} language="html" - filename="OG Meta Tags" /> + +
+ + OG images are cached by social platforms. Change the prompt to regenerate. + +
-
- - OG images are crawled once and cached by social platforms. Change the prompt to - generate a new image for updated content. - -
-
+ {/* Features */} +
+

Features

+

+ 1:1 · Feature grids, benefit sections, icons +

- {/* Features Block */} -
- - Features Block - -

- Aspect ratio: 1:1 -

-

- Use case: Feature grids, benefit sections, - service highlights. -

+ +
+
+ Lightning Fast +

Lightning Fast

+

+ Deploy in seconds with our global CDN +

+
+
+ Secure by Default +

Secure by Default

+

Enterprise-grade security built in

+
+
+ Easy Integration +

Easy Integration

+

Works with your existing stack

+
+
+
- -
-

Why Choose Us

-
-
-
- Lightning Fast -

Lightning Fast

-

Deploy in seconds with our global CDN

-
-
- Secure by Default -

Secure by Default

-

Enterprise-grade security built in

-
-
- Easy Integration -

Easy Integration

-

Works with your existing stack

-
-
-
- -
-
- Feature -

Feature Title

-

Feature description goes here.

-
- -
`} + code={`Feature icon`} language="html" - filename="Features Grid Code" />
@@ -628,64 +571,31 @@ export default function PlaceholderImagesGuidePage() { File-based Workflow

- Sometimes you need image files in your repository instead of URLs. + Need files in your repo? Here's how to download generated images.

- - When to Use Files - +

When to Use Files

    -
  • - Next.js projects with /public folder -
  • -
  • Static site generators requiring local assets
  • -
  • Version-controlled images
  • -
  • Offline development
  • +
  • Next.js/React projects with local image imports
  • +
  • Version-controlled placeholder assets
  • +
  • Offline or CI/CD environments
- - API Generation + Download - -

- Generate an image and save it locally: -

- +

Generate via API