Open-source personal finance manager. Self-hosted, privacy-first.
import React, { useState } from 'react'
import { useTranslation } from 'react-i18next'
import { useDisplayLocale } from '@/hooks/use-display-locale'
import { monthLabel } from '@/lib/month-utils'
import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query'
import { categories as categoriesApi, categoryGroups as groupsApi, budgets as budgetsApi } from '@/lib/api'
import { extractApiError } from '@/lib/api-errors'
import { toast } from 'sonner'
import { Button } from '@/components/ui/button'
import { DeleteConfirmationDialog } from '@/components/delete-confirmation-dialog'
import { Input } from '@/components/ui/input'
import { Label } from '@/components/ui/label'
import {
Dialog,
DialogContent,
DialogHeader,
DialogTitle,
DialogFooter,
} from '@/components/ui/dialog'
import type { Budget, BudgetSuggestion } from '@/types'
import { Pencil, Trash2, Plus, Repeat, CalendarIcon, Sparkles } from 'lucide-react'
import { format } from 'date-fns'
import { Popover, PopoverTrigger, PopoverContent } from '@/components/ui/popover'
import { MonthPicker } from '@/components/ui/monthpicker'
import { PageHeader } from '@/components/page-header'
import { CategoryIcon } from '@/components/category-icon'
import { usePrivacyMode } from '@/hooks/use-privacy-mode'
import { useAuth } from '@/contexts/auth-context'
import { useWorkspace } from '@/contexts/workspace-context'
import { resolveDateFnsLocale } from '@/lib/date-fns-locale'
import { findCategoryReference } from '@/lib/category-reference-utils'
import { formatCurrency } from '@/lib/format'
function currentMonth() {
const now = new Date()
return `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}`
}
const TH = 'text-xs font-medium text-muted-foreground py-3'
function SectionCard({ children }: { children: React.ReactNode }) {
return (
<div className="bg-card rounded-xl border border-border shadow-sm overflow-hidden">
{children}
</div>
)
}
function SectionHeader({ title, action }: { title: string; action?: React.ReactNode }) {
return (
<div className="px-4 sm:px-5 py-4 border-b border-border flex flex-wrap items-center justify-between gap-2">
<p className="text-sm font-semibold text-foreground">{title}</p>
{action}
</div>
)
}
export default function BudgetsPage() {
const { t, i18n } = useTranslation()
const { mask } = usePrivacyMode()
const { user } = useAuth()
const { canWrite } = useWorkspace()
const userCurrency = user?.preferences?.currency_display ?? 'USD'
const locale = useDisplayLocale()
const queryClient = useQueryClient()
const [selectedMonth, setSelectedMonth] = useState(currentMonth)
const [monthCalOpen, setMonthCalOpen] = useState(false)
const dateFnsLocale = resolveDateFnsLocale(i18n.resolvedLanguage ?? i18n.language)
const monthParam = `${selectedMonth}-01`
const [dialogOpen, setDialogOpen] = useState(false)
const [editing, setEditing] = useState<Budget | null>(null)
const [deletingBudget, setDeletingBudget] = useState<Budget | null>(null)
const [suggestOpen, setSuggestOpen] = useState(false)
const [suggestMonths, setSuggestMonths] = useState(3)
const [suggestRecurring, setSuggestRecurring] = useState(false)
const [suggestEdits, setSuggestEdits] = useState<Record<string, { checked: boolean; amount: string }>>({})
const { data: budgetsList } = useQuery({
queryKey: ['budgets', selectedMonth],
queryFn: () => budgetsApi.list(monthParam),
})
const { data: categoriesList } = useQuery({
queryKey: ['categories'],
queryFn: categoriesApi.list,
})
// Budgets can point at a hidden default category. The picker below only
// offers visible ones, but existing rows still have to name what they budget.
const { data: allCategoriesList } = useQuery({
queryKey: ['categories', 'management'],
queryFn: categoriesApi.listIncludingHidden,
})
const { data: groupsList } = useQuery({
queryKey: ['category-groups'],
queryFn: groupsApi.list,
})
const { data: suggestionData, isPending: suggestionsPending, isError: suggestionsError } = useQuery({
queryKey: ['budgets', 'suggestions', monthParam, suggestMonths],
queryFn: () => budgetsApi.suggestions(monthParam, suggestMonths),
enabled: suggestOpen,
})
// Rows default to the fetched suggestions; user edits layer on top.
// Edits are reset when the dialog opens or the period changes.
const rowFor = (s: BudgetSuggestion) =>
suggestEdits[s.category_id] ?? { checked: !s.existing_budget, amount: s.suggested_amount }
const suggestable = (suggestionData?.suggestions ?? []).filter((s) => !s.existing_budget)
const batchItems = suggestable.filter((s) => {
const row = rowFor(s)
return row.checked && parseFloat(row.amount) > 0
})
const batchMutation = useMutation({
mutationFn: () =>
budgetsApi.createBatch({
month: monthParam,
is_recurring: suggestRecurring,
items: batchItems.map((s) => ({
category_id: s.category_id,
amount: parseFloat(rowFor(s).amount),
})),
}),
onSuccess: (created) => {
queryClient.invalidateQueries({ queryKey: ['budgets'] })
setSuggestOpen(false)
toast.success(t('budgets.suggestCreated', { count: created.length }))
},
onError: (err: unknown) => {
toast.error(extractApiError(err, t('common.error')))
},
})
const createMutation = useMutation({
mutationFn: (data: { category_id: string; amount: number; month: string; is_recurring?: boolean }) =>
budgetsApi.create(data),
onSuccess: () => {
queryClient.invalidateQueries({ queryKey: ['budgets'] })
setDialogOpen(false)
toast.success(t('budgets.created'))
},
onError: () => toast.error(t('common.error')),
})
const updateMutation = useMutation({
mutationFn: ({ id, amount }: { id: string; amount: number }) =>
budgetsApi.update(id, { amount }),
onSuccess: () => {
queryClient.invalidateQueries({ queryKey: ['budgets'] })
setDialogOpen(false)
setEditing(null)
toast.success(t('budgets.updated'))
},
onError: () => toast.error(t('common.error')),
})
const deleteMutation = useMutation({
mutationFn: (id: string) => budgetsApi.delete(id),
onSuccess: () => {
queryClient.invalidateQueries({ queryKey: ['budgets'] })
setDeletingBudget(null)
toast.success(t('budgets.deleted'))
},
onError: (err: unknown) => {
toast.error(extractApiError(err, t('common.error')))
},
})
const displayCategories = allCategoriesList ?? categoriesList ?? []
const getCategoryDisplay = (categoryId: string) => {
const category = findCategoryReference(displayCategories, categoryId)
if (!category) return <span>{categoryId}</span>
return (
<span className="flex items-center gap-2">
<CategoryIcon icon={category.icon} color={category.color} size="sm" />
<span>{category.name}</span>
</span>
)
}
const uiLocale = i18n.resolvedLanguage ?? i18n.language
const monthTitle = monthLabel(selectedMonth, uiLocale).replace(/^\w/, c => c.toUpperCase())
return (
<div>
<PageHeader
section={t('budgets.title')}
title={monthTitle}
action={
<div className="flex items-center gap-1">
<button
className="h-8 w-8 flex items-center justify-center rounded-lg border border-border bg-card text-muted-foreground hover:border-border hover:text-foreground transition-all text-base"
onClick={() => {
const [y, m] = selectedMonth.split('-').map(Number)
const d = new Date(y, m - 2, 1)
setSelectedMonth(`${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}`)
}}
>‹</button>
<Popover open={monthCalOpen} onOpenChange={setMonthCalOpen}>
<PopoverTrigger asChild>
<button
type="button"
className="inline-flex items-center justify-center gap-2 border border-border rounded-lg px-3 py-1.5 text-sm bg-card text-foreground hover:bg-muted/50 transition-all cursor-pointer min-w-[180px]"
>
<CalendarIcon className="size-3.5 text-muted-foreground" />
{monthTitle}
</button>
</PopoverTrigger>
<PopoverContent align="center" className="w-auto p-0">
<MonthPicker
locale={dateFnsLocale}
selectedMonth={new Date(`${selectedMonth}-01T00:00:00`)}
onMonthSelect={(date) => {
if (!date) return
setSelectedMonth(format(date, 'yyyy-MM'))
setMonthCalOpen(false)
}}
/>
</PopoverContent>
</Popover>
<button
className="h-8 w-8 flex items-center justify-center rounded-lg border border-border bg-card text-muted-foreground hover:border-border hover:text-foreground transition-all text-base"
onClick={() => {
const [y, m] = selectedMonth.split('-').map(Number)
const d = new Date(y, m, 1)
setSelectedMonth(`${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}`)
}}
>›</button>
</div>
}
/>
<SectionCard>
<SectionHeader
title={t('budgets.title')}
action={
canWrite ? (
<div className="flex items-center gap-2">
<Button size="sm" variant="outline" className="gap-1.5 h-8" onClick={() => { setSuggestEdits({}); setSuggestOpen(true) }}>
<Sparkles size={13} /> {t('budgets.suggest')}
</Button>
<Button size="sm" className="gap-1.5 h-8" onClick={() => { setEditing(null); setDialogOpen(true) }}>
<Plus size={13} /> {t('budgets.add')}
</Button>
</div>
) : undefined
}
/>
{budgetsList && budgetsList.length > 0 ? (
<table className="w-full">
<thead>
<tr className="border-b border-border">
<th className={`${TH} pl-4 sm:pl-5 text-left`}>{t('budgets.category')}</th>
<th className={`${TH} text-left w-36`}>{t('budgets.amount')}</th>
{canWrite && <th className={`${TH} pr-4 sm:pr-5 text-right w-24`}>{t('budgets.actions')}</th>}
</tr>
</thead>
<tbody>
{budgetsList.map((budget) => (
<tr key={budget.id} className="border-b border-border last:border-0 hover:bg-muted transition-colors">
<td className="py-3 pl-4 sm:pl-5 text-sm font-medium text-foreground">
<span className="flex items-center gap-1.5">
{getCategoryDisplay(budget.category_id)}
{budget.is_recurring && (
<span title={t('budgets.recurringLabel')} className="text-muted-foreground">
<Repeat size={12} />
</span>
)}
</span>
</td>
<td className="py-3 text-sm font-semibold tabular-nums text-foreground">{mask(formatCurrency(budget.amount, userCurrency, locale))}</td>
{canWrite && (
<td className="py-3 pr-4 sm:pr-5">
<div className="flex items-center justify-end gap-1">
<button
className="p-1.5 rounded-md text-muted-foreground hover:text-primary hover:bg-primary/5 transition-colors"
onClick={() => { setEditing(budget); setDialogOpen(true) }}
aria-label={t('common.edit')}
title={t('common.edit')}
>
<Pencil size={13} />
</button>
<button
className="p-1.5 rounded-md text-muted-foreground hover:text-rose-500 hover:bg-rose-50 transition-colors"
onClick={() => setDeletingBudget(budget)}
disabled={deleteMutation.isPending}
aria-label={t('common.delete')}
title={t('common.delete')}
>
<Trash2 size={13} />
</button>
</div>
</td>
)}
</tr>
))}
</tbody>
</table>
) : (
<p className="text-sm text-muted-foreground text-center py-10">{t('budgets.empty')}</p>
)}
</SectionCard>
<Dialog open={dialogOpen} onOpenChange={() => { setDialogOpen(false); setEditing(null) }}>
<DialogContent>
<DialogHeader>
<DialogTitle>{editing ? t('budgets.edit') : t('budgets.add')}</DialogTitle>
</DialogHeader>
<form
key={editing?.id ?? 'new'}
onSubmit={(e) => {
e.preventDefault()
const formData = new FormData(e.currentTarget)
if (editing) {
updateMutation.mutate({
id: editing.id,
amount: parseFloat(formData.get('amount') as string),
})
} else {
const isRecurring = formData.get('is_recurring') === 'on'
createMutation.mutate({
category_id: formData.get('category_id') as string,
amount: parseFloat(formData.get('amount') as string),
month: monthParam,
is_recurring: isRecurring,
})
}
}}
className="space-y-4"
>
{!editing && (
<>
<div className="space-y-2">
<Label>{t('budgets.category')}</Label>
<select
name="category_id"
className="w-full border border-border rounded-lg px-3 py-2 text-sm bg-card text-foreground focus:outline-none focus:ring-2 focus:ring-primary"
required
>
<option value="">{t('budgets.selectCategory')}</option>
{groupsList?.map((group) => (
<optgroup key={group.id} label={group.name}>
{group.categories.map((cat) => (
<option key={cat.id} value={cat.id}>{cat.name}</option>
))}
</optgroup>
))}
{categoriesList?.filter((c) => !c.group_id).map((cat) => (
<option key={cat.id} value={cat.id}>{cat.name}</option>
))}
</select>
</div>
<label className="flex items-center gap-2 cursor-pointer">
<input type="checkbox" name="is_recurring" className="rounded border-border" />
<span className="text-sm text-foreground">{t('budgets.repeatEveryMonth')}</span>
</label>
</>
)}
<div className="space-y-2">
<Label>{t('budgets.amount')}</Label>
<Input
name="amount"
type="number"
step="0.01"
defaultValue={editing?.amount?.toString() ?? ''}
required
/>
</div>
<DialogFooter>
<Button type="button" variant="outline" onClick={() => { setDialogOpen(false); setEditing(null) }}>
{t('common.cancel')}
</Button>
<Button type="submit" disabled={createMutation.isPending || updateMutation.isPending}>
{t('common.save')}
</Button>
</DialogFooter>
</form>
</DialogContent>
</Dialog>
<Dialog open={suggestOpen} onOpenChange={(open) => { setSuggestOpen(open); if (!open) setSuggestEdits({}) }}>
<DialogContent>
<DialogHeader>
<DialogTitle>{t('budgets.suggestTitle')}</DialogTitle>
</DialogHeader>
<div className="space-y-4">
<div className="flex items-center gap-4">
<div className="space-y-1">
<Label>{t('budgets.suggestPeriod')}</Label>
<select
value={suggestMonths}
onChange={(e) => { setSuggestMonths(Number(e.target.value)); setSuggestEdits({}) }}
className="w-full border border-border rounded-lg px-3 py-2 text-sm bg-card text-foreground focus:outline-none focus:ring-2 focus:ring-primary"
>
<option value={3}>3 {t('budgets.suggestMonths')}</option>
<option value={6}>6 {t('budgets.suggestMonths')}</option>
<option value={12}>12 {t('budgets.suggestMonths')}</option>
</select>
</div>
<label className="flex items-center gap-2 cursor-pointer mt-5">
<input
type="checkbox"
checked={suggestRecurring}
onChange={(e) => setSuggestRecurring(e.target.checked)}
className="rounded border-border"
/>
<span className="text-sm text-foreground">{t('budgets.repeatEveryMonth')}</span>
</label>
</div>
<p className="text-sm text-muted-foreground">
{t('budgets.suggestDescription', { months: suggestMonths })}
</p>
{suggestionsPending ? (
<p className="text-sm text-muted-foreground text-center py-8">{t('common.loading')}</p>
) : suggestionsError ? (
<p role="alert" className="text-sm text-destructive text-center py-8">{t('budgets.suggestError')}</p>
) : suggestable.length === 0 ? (
<p className="text-sm text-muted-foreground text-center py-8">{t('budgets.suggestEmpty')}</p>
) : (
<div className="max-h-72 overflow-y-auto rounded-lg border border-border">
{suggestable.map((s) => {
const row = rowFor(s)
return (
<div key={s.category_id} className="flex items-center gap-3 border-b border-border last:border-0 px-3 py-2">
<input
type="checkbox"
checked={row.checked}
onChange={(e) =>
setSuggestEdits((prev) => ({
...prev,
[s.category_id]: { ...rowFor(s), checked: e.target.checked },
}))
}
className="rounded border-border"
aria-label={s.category_name}
/>
<span className="flex-1 text-sm font-medium text-foreground truncate">{s.category_name}</span>
<span className="text-xs text-muted-foreground tabular-nums whitespace-nowrap">
{t('budgets.suggestSpent', { amount: formatCurrency(Number(s.total_spent), userCurrency, locale) })}
</span>
<Input
type="number"
step="0.01"
min="0"
value={row.amount}
onChange={(e) =>
setSuggestEdits((prev) => ({
...prev,
[s.category_id]: { ...rowFor(s), amount: e.target.value },
}))
}
className="w-24 h-8"
aria-label={`${s.category_name} ${t('budgets.amount')}`}
/>
</div>
)
})}
</div>
)}
</div>
<DialogFooter>
<Button type="button" variant="outline" onClick={() => setSuggestOpen(false)}>
{t('common.cancel')}
</Button>
<Button
type="button"
disabled={batchMutation.isPending || batchItems.length === 0}
onClick={() => batchMutation.mutate()}
>
{t('budgets.suggestCreate')}
</Button>
</DialogFooter>
</DialogContent>
</Dialog>
<DeleteConfirmationDialog
open={!!deletingBudget}
title={t('budgets.confirmDeleteTitle')}
description={t(
deletingBudget?.is_recurring
? 'budgets.confirmDeleteRecurringDescription'
: 'budgets.confirmDeleteDescription',
{
name: findCategoryReference(displayCategories, deletingBudget?.category_id ?? '')?.name
?? t('budgets.category'),
},
)}
isPending={deleteMutation.isPending}
onClose={() => setDeletingBudget(null)}
onConfirm={() => deletingBudget && deleteMutation.mutate(deletingBudget.id)}
/>
</div>
)
}