Skip to content

docs(readme): add preview image to the README - #6

Merged
Uzair-Ahmed-Dahraj merged 1 commit into
mainfrom
ft4/readme-preview-image
Aug 3, 2026
Merged

Uzair-Ahmed-Dahraj merged 1 commit into
mainfrom
ft4/readme-preview-image

Conversation

@Uzair-Ahmed-Dahraj

Copy link
Copy Markdown
Collaborator

What

Adds a 16:9 screenshot of the public /preview page as a README hero image, placed just under the Deploy to Cloudflare button.

Why

The repo is being open-sourced and submitted to cloudflare/templates. Right now the README opens with badges and a text description only, so a visitor has to click through to the live deployment to see what the template actually looks like.

Cloudflare's own contributing guide asks for this: "You should also include a screenshot and/or live deployment of the application", and their template checklist asks for a 16:9 preview image at least 500px wide. This image is 3200x1800.

Notes

  • The image sits above the <!-- dash-content-start --> marker, so it is excluded from the block Cloudflare renders in the dashboard, where a relative path would not resolve.
  • The same file is being added to the template submission, where a Cloudflare reviewer uploads it to their image CDN and wires up cloudflare.preview_image_url. That field can only be set by a Cloudflare team member, so committing the asset is how they receive it.
  • Screenshot contains no credentials, store data, or binding IDs.

Adds a 16:9 screenshot of the public /preview page as a README hero, so
the repo landing page shows what the template looks like before anyone
clicks through to the live deployment.

@Uzair-Ahmed-Dahraj Uzair-Ahmed-Dahraj left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed, If needed preview will be swapped with actual Polaris UI preview.

Fine according to cloudflare contributing guide, they need a preview anyway, no mention of what to do incase of an embedded app.

@Uzair-Ahmed-Dahraj
Uzair-Ahmed-Dahraj merged commit fe677ad into main Aug 3, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant