Skip to content

feat: add Time Scale Filter component #980

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
sharaddh wants to merge 1 commit into
base: main
Choose a base branch
from
Open

feat: add Time Scale Filter component #980

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
6 changes: 6 additions & 0 deletions apps/www/config/docs.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -182,6 +182,12 @@ export const docsConfig: DocsConfig = {
{
title: "Components",
items: [
{
title: "Time Scale Filter",
href: "/docs/components/time-scale-filter",
items: [],
label: "New",
},
{
title: "Marquee",
href: `/docs/components/marquee`,
Expand Down
58 changes: 58 additions & 0 deletions apps/www/content/docs/components/time-scale-filter.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
---
title: Time Scale Filter
date: 2026-06-07
description: Analog timeline date filtering component
author: magicui
published: true
---

<ComponentPreview name="time-scale-filter-demo" />

## Installation

<Tabs defaultValue="cli">

<TabsList>
<TabsTrigger value="cli">CLI</TabsTrigger>
<TabsTrigger value="manual">Manual</TabsTrigger>
</TabsList>

<TabsContent value="cli">

```bash
npx shadcn@latest add @magicui/time-scale-filter
```

</TabsContent>

<TabsContent value="manual">

<ComponentSource name="time-scale-filter" />

</TabsContent>

</Tabs>

## Usage

```tsx
<TimeScaleFilter
data={orders}
dateField="createdAt"
renderItem={(order) => <OrderCard key={order.id} order={order} />}
initialDate={new Date()}
/>
```

## Props

| Prop | Type | Description |
| ---------------- | ---------------------- | ---------------------------------------------------- |
| data | T[] | Array of items to filter |
| dateField | keyof T | Date field used for filtering |
| renderItem | (item: T) => ReactNode | Render function for each filtered item |
| timelineDays | number | Number of days shown in the timeline |
| emptyMessage | string | Message shown when no items match |
| className | string | Optional wrapper class name |
| contentClassName | string | Optional class name for the rendered content section |
| initialDate | Date | Optional timeline start date |
Loading
Loading