Problem/Motivation

The Varbase Starter card in the Drupal CMS site-template picker has two defects.

  • The image is not a site screenshot at all. The shipped screenshot.webp on 1.0.x is the navy Varbase brand logo lockup, 632x304 (2.08:1). Every other card in the picker shows a preview of the site the template builds; Varbase Starter shows no site at all, so nobody choosing a template can see what they would get.
  • It is also the wrong shape. The card frame is roughly 1.25:1 with object-fit: cover, so a 2.08:1 image is cropped on both sides even once it does carry a page.
  • The description is developer-facing. It currently reads "A starter site template recipe for Varbase, providing a modern recipe-first approach to initializing Varbase sites." Peer cards describe who the template serves and what it includes, not how it is implemented.

The shipped screenshot.webp at 1:1:

The shipped screenshot.webp, 632x304, showing the navy Varbase brand logo lockup rather than a site

Steps to reproduce

  1. Build a Drupal CMS site with the Varbase Starter recipe available.
  2. Open the browser installer and go to the "Choose a site template" step.
  3. Compare the Varbase Starter card with the Educare, RightUp, Haven, Byte and Everbright cards.
  4. Varbase Starter is the only card with no site preview, and the only one whose description does not open with "Designed for ...".

Proposed resolution

  • Replace screenshot.webp with a 500x400 image, the size the other cards in the picker use, so it fills the frame with no crop. The file name must stay exactly screenshot.webp.
  • The image is a design render, not a browser capture: it is sourced from the approved Figma stylesheet (VB - Approved Stylesheet), cropped to the top 1.25:1 band of the 1440-wide page design and resampled. This is the same method used for RightUp. The installed Varbase Starter front page genuinely renders this layout (hero slider plus features section), so the preview is faithful to what the template builds.
  • Rewrite description in recipe.yml in the Drupal CMS house style: "Designed for teams starting a new Varbase site, this template features ready-made home, about, features, blog and contact pages, with blog posts, a media library, search, a contact form and built-in SEO and accessibility tools."

Every claim in that description was checked on a running install: five Canvas pages (/home, /about-varbase, /features, /blog, /contact-us, all HTTP 200), 12 blog nodes, 59 media items with Media Library, Search API with /search at HTTP 200, the business-contact webform on /contact-us, Metatag and Simple XML Sitemap, and Editoria11y.

After, in the same installer:

 the Varbase Starter card shows an uncropped 500x400 site preview matching the peer cards

The same change on the sibling site templates: #3620996 (Educare), #3621001 (RightUp) and #3620998 (Horizon Aid).

Remaining tasks

  • ✅ File an issue
  • ✅ Addition/Change/Update/Fix
  • ✅ Testing to ensure no regression
  • ➖ Automated unit/functional testing coverage
  • ➖ Developer Documentation support
  • ➖ User Guide Documentation support
  • ❌ UX/UI designer responsibilities
  • ➖ Accessibility and Readability
  • ❌ Reviewed by a human
  • ❌ Code review by maintainers
  • ❌ Full testing and approval
  • ❌ Credit contributors
  • ❌ Review with the product owner
  • ❌ Update Release Notes
  • ❌ Release

User interface changes

  • The Varbase Starter card in the Drupal CMS site-template picker shows an uncropped 500x400 preview of the site the template builds, and a description written for the person choosing a template.

API changes

  • N/A

Data model changes

  • N/A

Release notes snippet

  • The Varbase Starter site template now shows a properly framed screenshot and a clearer description in the Drupal CMS installer.
Command icon Show commands

Start within a Git clone of the project using the version control instructions.

Or, if you do not have SSH keys set up on git.drupalcode.org:

Comments

rajab natshah created an issue. See original summary.

rajab natshah’s picture

Status: Active » Needs review

Merge request !43 is open against 1.0.x with both changes.

The card image is now 500x400, the ratio of the picker's own image box, so nothing is cropped. It replaces the navy Varbase brand logo lockup that shipped before, which was not a site preview at all: the new image is sourced from the approved Figma stylesheet, cropped to the top 1.25:1 band of the 1440-wide page design and resampled, so the card shows the header and navigation, the hero and the opening of the features section below it. The installed Varbase Starter front page renders that layout, so the preview is faithful to what the template builds.

The description now opens with "Designed for" and names what the template ships, matching the format the other cards use. Every claim in it was checked on a running install: the five Canvas pages, the blog posts, the media library, search, the contact form, and the SEO and accessibility tooling.

Verified in the real Drupal CMS installer, driven to the site-template step in a real browser and compared against the other site templates in the picker. The before and after screenshots are embedded in the issue summary.

  • rajab natshah committed 7edc645b on 1.0.x
    fix: #3621003 Reshoot the installer card screenshot at 500x400 and...
rajab natshah’s picture

Issue summary: View changes
rajab natshah’s picture

Status: Needs review » Fixed
Issue tags: +varbase_starter-1.0.0

Now that this issue is closed, review the contribution record.

As a contributor, attribute any organization that helped you, or if you volunteered your own time.

Maintainers, credit people who helped resolve this issue.

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.