Skip to content

feat: add bilingual topic page templates with CSS shortcuts#116

Draft
delisma wants to merge 1 commit intocds-snc:mainfrom
delisma:feature/202510-topic-pages
Draft

feat: add bilingual topic page templates with CSS shortcuts#116
delisma wants to merge 1 commit intocds-snc:mainfrom
delisma:feature/202510-topic-pages

Conversation

@delisma
Copy link

@delisma delisma commented Oct 23, 2025

This PR introduces comprehensive bilingual topic page templates that demonstrate modern GCDS (Government of Canada Design System) implementation with CSS utility shortcuts.

Complete Topic Page Structure:

  • Hero section with title and optional image
  • "Most Requested" tasks section with gray background
  • "Services and Information" grid layout (9 items, 3x3 desktop)
  • Featured content section with hover effects
  • Social media links with custom icons
  • Department/agency attribution with vertical bar separators

Related issues

While building the templates we have encountered a few issues

Usage

These templates serve as prototypes of topic pages that follow Canada.ca design standards while leveraging GCDS components and CSS shortcuts for efficient development. A few patterns should be considered to be transformed into a GCDS components in order to introduce variants of patterns and reduce verbosity of some tag elements.

cc: @jmealing

@delisma delisma changed the title feat: add topic page templates (English/French) with CSS shortcuts feat: add bilingual topic page templates with CSS shortcuts Oct 23, 2025
Comment on lines +180 to +183
<div>
<gcds-link class="font-family-heading font-bold mt-0" href="#">[Hyperlink text]</gcds-link>
<p class="font-size-text-small lg:mb-200 xs:mb-0">Use action verbs, or simply list keywords to summarize the information or tasks that can be accomplished on the page it links to</p>
</div>
Copy link

Choose a reason for hiding this comment

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

Should this bloc be a gcds-card?

Copy link

@jmealingcds jmealingcds Oct 24, 2025

Choose a reason for hiding this comment

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

@duboisp No, the Service and information doormat will not be replaced by the GCDS card design. The design components of the Canada.ca specifications will be brought into GCDS. Whether it becomes it's own component or not, because it has variants, single column 2/3, grey banding bkg or not, etc. we will see as we go with this contribution.

<gcds-container size="xl" main-container centered>
<gcds-grid columns="1" columns-tablet="1" columns-desktop="auto 1fr">
<!-- Heading column -->
<h2 class="limit mt-0 mb-0 font-size-h3">Most requested</h2>
Copy link

Choose a reason for hiding this comment

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

I suggest to move this heading between the "section" and the "gcds-container" element because if the user change the number of column in the gcds-grid layout, that will impact how that heading is displayed and might provide unexpected result.

Copy link

@jmealingcds jmealingcds Oct 24, 2025

Choose a reason for hiding this comment

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

@duboisp This is a proof of concept to use CSS styles to produce Canada.ca specifications with GCDS to keep moving us forward, this should not be available for a user to modify the design and column of components like Most requested. Ideally, we turn it into a component.

Is there any other reason to move it?

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.

3 participants