Skip to content

docs(ui): add stories for blog index page #2679

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
IestynGage wants to merge 2 commits into
base: main
Choose a base branch
from
+46 −0
Open

docs(ui): add stories for blog index page #2679

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
91f3284
docs(ui): add stories for blog index page (#2679)
IestynGage May 5, 2026
3e50452
Test commit to check chromatic.
IestynGage May 8, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 30 additions & 0 deletions app/pages/blog/another-blog.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
---
authors:
- name: Alex Savelyev
blueskyHandle: alexdln.com
- name: Philippe Serhal
blueskyHandle: philippeserhal.com
- name: Matias Capeletto
blueskyHandle: patak.cat
title: 'Another blog about toast'
tags: ['OpenSource', 'Release']
excerpt: 'Something about toast and potatoes, they are good food.'
date: '2026-05-08'
slug: 'release/0.8'
image: 'https://npmx.dev/blog/og/release-0_8.png'
description: 'Something about toast and potatoes, they are good food. And something about butter'
draft: false
---

# Toast

Info about toast.

# Potatoes

Infor about potatoes.

# Conclusion

Both go well with butter.
But not jam, only toast goes well with jam.
16 changes: 16 additions & 0 deletions app/pages/blog/index.stories.ts
View file
Open in desktop
Copy link
Copy Markdown
Contributor

@cylewaitforit cylewaitforit May 6, 2026 •
edited
Loading

Choose a reason for hiding this comment

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

The new story renders fine in the PR's deployed storybook .

@ghostdevv I don't have access to check the Chromatic tests anymore so you may want to check what the visual regression tests capture.

It looks like the blogs that are being displayed are live data. So my assumption is that would probably mean the chromatic tests would suddenly be out of date when a new blog post is added.

So while I know both are ultimately wanted, we would need to decide if disabling visual regression tests on this page to start would be a blocker to merging or if increasing the coverage of our documented pages is a fine enough short term goal.

If documenting to start is the more important goal then we could add the chromatic parameter to disable.

const meta = {
  component: Blog,
  parameters: {
    layout: 'fullscreen",
    // Disables Chromatic's snapshotting on a component level
    chromatic: { disableSnapshot: true },
  },
  decorators: [pageDecorator],
} satisfies Meta<typeof Blog>;

https://www.chromatic.com/docs/disable-snapshots/#with-storybook

We would probably want to then add a follow up issue to mock out the blog posts in order to re-enable snapshots.

Copy link
Copy Markdown
Contributor

@cylewaitforit cylewaitforit May 7, 2026

Choose a reason for hiding this comment

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

Update:

I have access to the chromatic tests again and understandably the snapshot has the same live data. So I think my assumption that new blog data would cause the snapshot to become outdated seems correct.

Copy link
Copy Markdown
Contributor

@ghostdevv ghostdevv May 8, 2026

Choose a reason for hiding this comment

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

could you take a look @IestynGage 👀

Copy link
Copy Markdown
Author

@IestynGage IestynGage May 8, 2026 •
edited
Loading

Choose a reason for hiding this comment

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

@cylewaitforit Could you clarify what you mean by live data? From your suggestion I thought the blog posts was from a CMS system. But if you see the spurios commit I added where I create a blog post. The storybook correctly updated. Kinda suggests to me that the cards are built by SSG. This works only if you restart nuxt/vite.

IDK maybe I'm missing something but it seems like they are built by a vite module in modules/blog.ts which creates a object in .nuxt/blog/posts.ts. If i'm missing something I'm happy to add the chromatic: { disableSnapshot: true }

Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
import Blog from './index.vue'
import type { Meta, StoryObj } from '@storybook-vue/nuxt'
import { pageDecorator } from '../../../.storybook/decorators'

const meta = {
component: Blog,
parameters: {
layout: 'fullscreen',
},
decorators: [pageDecorator],
} satisfies Meta<typeof Blog>

export default meta
type Story = StoryObj<typeof meta>

export const Default: Story = {}
Loading