⚡ Project management that doesn't become the project. Boards, Gantt charts, and GitHub integration. Self-host it or use Kaneo Cloud.
TypeScript honoissue-managementissue-trackerjira-alternativekanbanlinear-alternativemcpproject-managementreactself-hostedtypescript
import { Calendar, CircleAlert, History, UserRound } from "lucide-react";
import { useTranslation } from "react-i18next";
import useActiveWorkspace from "@/hooks/queries/workspace/use-active-workspace";
import useGetWorkspaceUsers from "@/hooks/queries/workspace-users/use-get-workspace-users";
import { formatDateMedium, formatRelativeTime } from "@/lib/format";
import { getInitials } from "@/lib/get-initials";
import { getPriorityLabel, getStatusLabel } from "@/lib/i18n/domain";
import { Avatar, AvatarFallback, AvatarImage } from "../ui/avatar";
import {
HoverCard,
HoverCardContent,
HoverCardTrigger,
} from "../ui/preview-card";
import { TimelineContent, TimelineItem } from "../ui/timeline";
import CommentCard from "./comment-card";
import { isCommentActivity } from "./utils";
type ActivityItem = {
type: string;
content: string | null;
eventData?: unknown;
id: string;
createdAt: string;
userId: string | null;
taskId: string;
externalUserName?: string | null;
externalUserAvatar?: string | null;
externalSource?: string | null;
externalUrl?: string | null;
};
function getEventDataRecord(
eventData: unknown,
): Record<string, unknown> | null {
if (!eventData || typeof eventData !== "object" || Array.isArray(eventData)) {
return null;
}
return eventData as Record<string, unknown>;
}
type WorkspaceUser = {
user?: {
id?: string;
name?: string | null;
email?: string | null;
image?: string | null;
} | null;
};
function getActivityTypeIcon(type: string) {
const iconClass = "size-3.5";
switch (type) {
case "status_changed":
return <History className={iconClass} />;
case "priority_changed":
return <CircleAlert className={iconClass} />;
case "due_date_changed":
return <Calendar className={iconClass} />;
case "assignee_changed":
case "unassigned":
return <UserRound className={iconClass} />;
default:
return <History className={iconClass} />;
}
}
function formatActivityDateText(value: string) {
const parsed = new Date(value);
if (!Number.isNaN(parsed.getTime())) {
return formatDateMedium(parsed);
}
const slashMatch = value.match(/^(\d{1,2})\/(\d{1,2})\/(\d{4})$/);
if (!slashMatch) return value;
const [, month, day, year] = slashMatch;
const fromSlashDate = new Date(`${year}-${month}-${day}T00:00:00`);
if (Number.isNaN(fromSlashDate.getTime())) return value;
return formatDateMedium(fromSlashDate);
}
function toDisplayCase(value: string) {
return value
.replace(/[-_]/g, " ")
.split(" ")
.filter(Boolean)
.map((part) => part.charAt(0).toUpperCase() + part.slice(1).toLowerCase())
.join(" ");
}
function findUserByName(users: WorkspaceUser[] | undefined, name: string) {
if (!users) return null;
const matches = users.filter(
(member) =>
member.user?.name?.toLowerCase().trim() === name.toLowerCase().trim(),
);
if (matches.length !== 1) return null;
return matches[0];
}
function UserHoverName({
user,
fallbackName,
}: {
user: WorkspaceUser | null;
fallbackName: string;
}) {
if (!user?.user) {
return (
<span className="font-medium text-foreground/85">{fallbackName}</span>
);
}
return (
<HoverCard>
<HoverCardTrigger asChild>
<span className="cursor-pointer font-medium text-foreground/85 transition-colors hover:text-foreground">
{user.user.name}
</span>
</HoverCardTrigger>
<HoverCardContent className="w-52 p-3">
<div className="flex items-center gap-3">
<Avatar className="h-8 w-8">
<AvatarImage
src={user.user.image ?? ""}
alt={user.user.name || ""}
/>
<AvatarFallback className="bg-muted text-xs font-medium">
{getInitials(user.user.name)}
</AvatarFallback>
</Avatar>
<div className="min-w-0 flex-1">
<p className="text-sm font-medium text-foreground leading-none">
{user.user.name}
</p>
<p className="mt-1 text-xs text-muted-foreground">
{user.user.email}
</p>
</div>
</div>
</HoverCardContent>
</HoverCard>
);
}
function ActorAvatar({
user,
fallbackName,
}: {
user: WorkspaceUser | null;
fallbackName: string;
}) {
return (
<Avatar className="size-4.5">
<AvatarImage src={user?.user?.image ?? ""} alt={fallbackName} />
<AvatarFallback className="bg-muted font-semibold text-[8px]">
{getInitials(fallbackName)}
</AvatarFallback>
</Avatar>
);
}
function renderActivityContent({
activity,
workspaceUsers,
t,
}: {
activity: ActivityItem;
workspaceUsers: WorkspaceUser[] | undefined;
t: (key: string, options?: Record<string, unknown>) => string;
}) {
const content = activity.content || "";
const eventData = getEventDataRecord(activity.eventData);
if (activity.type === "priority_changed") {
if (eventData) {
return (
<span className="text-muted-foreground">
{t("activity:changedPriority", {
from: getPriorityLabel(String(eventData.oldPriority ?? "")),
to: getPriorityLabel(String(eventData.newPriority ?? "")),
})}
</span>
);
}
const match = content.match(
/changed priority from "?(.+?)"? to "?(.+?)"?$/i,
);
if (!match) {
return <span className="text-muted-foreground">{content}</span>;
}
return (
<span className="text-muted-foreground">
{t("activity:changedPriority", {
from: getPriorityLabel(match[1]),
to: getPriorityLabel(match[2]),
})}
</span>
);
}
if (activity.type === "status_changed") {
if (eventData) {
return (
<span className="text-muted-foreground">
{t("activity:changedStatus", {
from: getStatusLabel(String(eventData.oldStatus ?? "")),
to: getStatusLabel(String(eventData.newStatus ?? "")),
})}
</span>
);
}
const match = content.match(/changed status from "?(.+?)"? to "?(.+?)"?$/i);
if (!match) {
return <span className="text-muted-foreground">{content}</span>;
}
return (
<span className="text-muted-foreground">
{t("activity:changedStatus", {
from: getStatusLabel(match[1]),
to: getStatusLabel(match[2]),
})}
</span>
);
}
if (activity.type === "due_date_changed") {
if (eventData) {
const oldDueDate = eventData.oldDueDate
? formatActivityDateText(String(eventData.oldDueDate))
: null;
const newDueDate = eventData.newDueDate
? formatActivityDateText(String(eventData.newDueDate))
: null;
return (
<span className="text-muted-foreground">
{newDueDate
? oldDueDate
? t("activity:changedDueDate", {
from: oldDueDate,
to: newDueDate,
})
: t("activity:setDueDate", { date: newDueDate })
: t("activity:clearedDueDate")}
</span>
);
}
const changeMatch = content.match(/changed due date from (.+) to (.+)$/i);
if (changeMatch) {
return (
<span className="text-muted-foreground">
{t("activity:changedDueDate", {
from: formatActivityDateText(changeMatch[1]),
to: formatActivityDateText(changeMatch[2]),
})}
</span>
);
}
const setMatch = content.match(/set due date to (.+)$/i);
if (setMatch) {
return (
<span className="text-muted-foreground">
{t("activity:setDueDate", {
date: formatActivityDateText(setMatch[1]),
})}
</span>
);
}
if (content.includes("cleared the due date")) {
return (
<span className="text-muted-foreground">
{t("activity:clearedDueDate")}
</span>
);
}
return <span className="text-muted-foreground">{content}</span>;
}
if (activity.type === "unassigned") {
return (
<span className="text-muted-foreground">{t("activity:unassigned")}</span>
);
}
if (activity.type === "assignee_changed") {
if (eventData) {
if (eventData.isSelfAssigned) {
return (
<span className="text-muted-foreground">
{t("activity:assignedToSelf")}
</span>
);
}
const targetId = String(eventData.newAssigneeId ?? "");
const targetName = String(eventData.newAssignee ?? "");
const targetUser =
workspaceUsers?.find((member) => member.user?.id === targetId) || null;
return (
<span className="text-muted-foreground">
{t("activity:assignedTo", {
name: targetUser?.user?.name ?? targetName,
})}
</span>
);
}
if (content.includes("themselves")) {
return (
<span className="text-muted-foreground">
{t("activity:assignedToSelf")}
</span>
);
}
const tokenMatch = content.match(
/assigned the task to \[\[user:([^|\]]+)\|([^\]]+)\]\]/,
);
if (tokenMatch) {
const [, targetId, targetName] = tokenMatch;
const targetUser =
workspaceUsers?.find((member) => member.user?.id === targetId) || null;
return (
<span className="text-muted-foreground">
{t("activity:assignedTo", {
name: targetUser?.user?.name ?? targetName,
})}
</span>
);
}
const legacyMatch = content.match(/assigned the task to (.+)$/i);
if (legacyMatch) {
const targetName = legacyMatch[1];
const targetUser = findUserByName(workspaceUsers, targetName);
return (
<span className="text-muted-foreground">
{t("activity:assignedTo", {
name: targetUser?.user?.name ?? targetName,
})}
</span>
);
}
}
if (activity.type === "title_changed") {
if (eventData) {
return (
<span className="text-muted-foreground">
{t("activity:changedTitle", {
from: String(eventData.oldTitle ?? ""),
to: String(eventData.newTitle ?? ""),
})}
</span>
);
}
const legacyMatch = content.match(/changed title from "(.+)" to "(.+)"$/i);
if (legacyMatch) {
return (
<span className="text-muted-foreground">
{t("activity:changedTitle", {
from: legacyMatch[1],
to: legacyMatch[2],
})}
</span>
);
}
}
if (activity.type === "moved") {
if (eventData) {
return (
<span className="text-muted-foreground">
{eventData.fromProjectName
? t("activity:moved", {
from: String(eventData.fromProjectName),
to: String(eventData.toProjectName ?? ""),
})
: t("activity:movedFromOtherProject", {
to: String(eventData.toProjectName ?? ""),
})}
</span>
);
}
}
if (["create", "created", "task"].includes(activity.type)) {
return (
<span className="text-muted-foreground">{t("activity:created")}</span>
);
}
return (
<span className="text-muted-foreground">
{content || toDisplayCase(activity.type)}
</span>
);
}
function Activity({
activity,
step,
}: {
activity: ActivityItem;
step: number;
}) {
const { t } = useTranslation();
const { data: workspace } = useActiveWorkspace();
const { data: workspaceUsers } = useGetWorkspaceUsers({
workspaceId: workspace?.id,
});
const user = activity.userId
? workspaceUsers?.find(
(workspaceUser) => workspaceUser.user?.id === activity.userId,
)
: null;
const isExternalComment = Boolean(activity.externalSource);
const actorName = user?.user?.name || t("common:people.someone");
if (isCommentActivity(activity)) {
const commentUser = isExternalComment
? {
id: undefined,
name: activity.externalUserName ?? t("activity:githubUser"),
email: undefined,
image: activity.externalUserAvatar ?? undefined,
}
: {
id: user?.user?.id,
name: user?.user?.name,
email: user?.user?.email,
image: user?.user?.image,
};
return (
<TimelineItem className="m-0! flex-row items-start py-1!" step={step}>
<TimelineContent className="min-w-0 flex-1">
<CommentCard
commentId={activity.id}
taskId={activity.taskId}
content={activity.content || ""}
user={commentUser}
createdAt={activity.createdAt}
importedBy={
activity.userId && activity.externalSource !== "github"
? actorName
: undefined
}
externalSource={activity.externalSource}
externalUrl={activity.externalUrl}
/>
</TimelineContent>
</TimelineItem>
);
}
const isCreated = ["create", "created", "task"].includes(activity.type);
return (
<TimelineItem
className="m-0! min-h-7 flex-row items-start gap-2.5 py-1! pl-2"
step={step}
>
<span className="flex h-5 w-4.5 shrink-0 items-center justify-center text-muted-foreground">
{isCreated ? (
<ActorAvatar user={user || null} fallbackName={actorName} />
) : (
getActivityTypeIcon(activity.type)
)}
</span>
<TimelineContent className="min-w-0 flex-1 text-[13px] text-foreground leading-5">
<UserHoverName user={user || null} fallbackName={actorName} />{" "}
{renderActivityContent({
activity,
workspaceUsers: workspaceUsers as WorkspaceUser[] | undefined,
t,
})}{" "}
<span className="whitespace-nowrap text-muted-foreground/60 text-xs">
· {formatRelativeTime(activity.createdAt)}
</span>
</TimelineContent>
</TimelineItem>
);
}
export default Activity;