# Carousel layout 01

> Latest posts in a carousel under a heading with a View all posts button.

URL: https://apogee.avaui.dev/docs/blog-sections/carousel-layout-01
Last updated: 2026-10-20

Latest posts in a carousel under a heading with a View all posts button.

Last updated October 20, 2026

Live example: https://apogee.avaui.dev/examples/blog/carousel-layout-01

```astro
---
/**
 * Carousel layout 01: Latest posts in a carousel under a heading with a View all posts button.
 *
 * @block blog
 * @order 17
 */
import Section from '@/components/apogee/Section/Section.astro'
import SectionHeader from '@/components/apogee/SectionHeader/SectionHeader.astro'
import PostCard from '@/components/apogee/PostCard/PostCard.astro'
import { plain } from '@/components/apogee/sections/_shared/spine.ts'
import { toCard, type BlogContent, type Post } from '@/components/apogee/sections/_shared/blog.ts'
import Button from '@/components/apogee/Button/Button.astro'
import Carousel from '@/components/apogee/Carousel/Carousel.astro'

const demoPosts: Post[] = [
  {
    title: 'Designing review sessions people look forward to',
    href: '#',
    excerpt: 'How to run critiques that sharpen the work instead of draining the room.',
    date: '2026-01-20',
    readingTime: '8 min read',
    image: { src: 'https://picsum.photos/seed/apogee-blog-1/960/640', alt: '', width: 960, height: 640 },
    category: { name: 'Design', href: '#' },
    author: { name: 'Ada Lovelace', href: '#' },
    tags: [{ name: 'Design', href: '#', color: 'primary' }, { name: 'Research', href: '#', color: 'neutral' }, { name: 'Process', href: '#', color: 'positive' }],
  },
  {
    title: 'Migrating to a typed component library',
    href: '#',
    excerpt: 'What changed when we moved two hundred screens onto one set of typed parts.',
    date: '2026-01-19',
    readingTime: '6 min read',
    image: { src: 'https://picsum.photos/seed/apogee-blog-2/960/640', alt: '', width: 960, height: 640 },
    category: { name: 'Engineering', href: '#' },
    author: { name: 'Alan Turing', href: '#' },
    tags: [{ name: 'Engineering', href: '#', color: 'primary' }, { name: 'Tooling', href: '#', color: 'neutral' }],
  },
  {
    title: 'Building your first internal API',
    href: '#',
    excerpt: 'The shape of a small API that teams can grow without rewriting.',
    date: '2026-01-18',
    readingTime: '7 min read',
    image: { src: 'https://picsum.photos/seed/apogee-blog-3/960/640', alt: '', width: 960, height: 640 },
    category: { name: 'Engineering', href: '#' },
    author: { name: 'Grace Hopper', href: '#' },
    tags: [{ name: 'Engineering', href: '#', color: 'primary' }, { name: 'APIs', href: '#', color: 'warning' }],
  },
  {
    title: 'A field guide to product discovery',
    href: '#',
    excerpt: 'Questions that turn a vague request into something you can build.',
    date: '2026-01-16',
    readingTime: '5 min read',
    image: { src: 'https://picsum.photos/seed/apogee-blog-4/960/640', alt: '', width: 960, height: 640 },
    category: { name: 'Product', href: '#' },
    author: { name: 'Katherine Johnson', href: '#' },
    tags: [{ name: 'Product', href: '#', color: 'primary' }, { name: 'Research', href: '#', color: 'neutral' }],
  },
  {
    title: 'Writing release notes people read',
    href: '#',
    excerpt: 'Lead with what changed for the reader, not what changed in the code.',
    date: '2026-01-15',
    readingTime: '4 min read',
    image: { src: 'https://picsum.photos/seed/apogee-blog-5/960/640', alt: '', width: 960, height: 640 },
    category: { name: 'Product', href: '#' },
    author: { name: 'Margaret Hamilton', href: '#' },
    tags: [{ name: 'Product', href: '#', color: 'primary' }, { name: 'Writing', href: '#', color: 'positive' }],
  },
  {
    title: 'Leadership lessons from a year of remote teams',
    href: '#',
    excerpt: 'Rituals, writing and trust: what held a distributed team together.',
    date: '2026-01-14',
    readingTime: '9 min read',
    image: { src: 'https://picsum.photos/seed/apogee-blog-6/960/640', alt: '', width: 960, height: 640 },
    category: { name: 'Leadership', href: '#' },
    author: { name: 'Alan Kay', href: '#' },
    tags: [{ name: 'Leadership', href: '#', color: 'primary' }, { name: 'Remote', href: '#', color: 'neutral' }],
  },
]
/** @composable */
interface Props extends BlogContent {}

const {
  eyebrow = 'Our blog',
  heading = 'Latest blog posts',
  description = 'Tools and strategies modern teams need to help their companies grow.',
  items = demoPosts,
  locale = Astro.currentLocale ?? 'en',
  primaryAction = { label: 'View all posts', href: '#' },
} = Astro.props

---

<Section spacing="large">
  <SectionHeader eyebrow={eyebrow ?? undefined} heading={plain(heading)} description={description ?? undefined} class="mb-12">
    {primaryAction && <Button slot="actions" href={primaryAction.href} size="large" class="max-sm:hidden">{primaryAction.label}</Button>}
  </SectionHeader>
  <Carousel label="Latest posts" visibleItems={{ base: 1, md: 2, lg: 3 }} gap={8} controlsPosition="below">
    {items.map((post) => <PostCard post={toCard(post)} locale={locale} meta="badge" headingLevel={3} class="h-full" />)}
  </Carousel>
  {primaryAction && <Button href={primaryAction.href} size="large" fullWidth class="mt-8 sm:hidden">{primaryAction.label}</Button>}
</Section>
```

## Add

```sh
npx @ava-ui/apogee add blog/carousel-layout-01
```

Every piece of copy is a prop, with the sample copy as its default. Pass yours, or `null` to hide a part; see [copy is props](https://apogee.avaui.dev/docs/blog-sections#copy-is-props).

This copies the block to `src/components/apogee/blocks/blog/` with everything it uses: Button, Carousel, PostCard, Section, SectionHeader. It slots into any page, such as a home page or a product page. Swap the `posts` array for your content collection. Use **Copy code** above to paste it instead.

## Accessibility

-   Each post is one link: the title stretches over the card, and the author, category and tag links sit above it and stay clickable.
-   The decorative arrow and the images are hidden from screen readers (their alt is empty because the title already names the post).
-   The carousel is a named region; its arrows are buttons and it scrolls by swipe or keyboard too.

## Related

[

PostCardOne article in a blog list; image, a top line, title, summary and a footer, as plain, a card or with an overlay.

](https://apogee.avaui.dev/docs/post-card)[

Blog listPost cards in a grid, or one featured post above the grid.

](https://apogee.avaui.dev/docs/sections/blog-list)