KalendarSchedule#

An hourly time grid for a single day — the "day view" of a typical calendar app. One day per page, navigable by arrow-click and swipe.

Timed events (those with a non-null startTime) render as blocks sized by their duration. Overlapping events pack side by side. All-day events (no startTime) pin as chips above the grid. A now-indicator line marks the current time on today's page, refreshing every minute. On first composition the grid starts scrolled to early morning rather than midnight.

Minimal example#

import androidx.compose.ui.graphics.Color
import com.himanshoe.kalendar.foundation.event.BasicKalendarEvent
import com.himanshoe.kalendar.KalendarSchedule
import com.himanshoe.kalendar.state.rememberKalendarScheduleState
import kotlinx.datetime.LocalDate
import kotlinx.datetime.LocalDateTime
import kotlinx.datetime.LocalTime

val today = LocalDate(2026, 8, 12)

KalendarSchedule(
    state = rememberKalendarScheduleState(initialDate = today),
    events = listOf(
        BasicKalendarEvent(
            date = today,
            eventName = "Design review",
            startTime = LocalDateTime(today, LocalTime(9, 0)),
            endTime = LocalDateTime(today, LocalTime(10, 0)),
            eventColor = Color(0xFFEF6C00),
        ),
    ),
    onEventClick = { event -> openDetails(event) },
)

Parameters#

Note: there is no selectedDate parameter. The Schedule views have no concept of date selection, so the day on screen is entirely the state's business — build one with rememberKalendarScheduleState(initialDate = …) to open somewhere other than today.

See Customization for what the content slots receive and how to fall back to the built-in rendering.

State factory#

rememberKalendarScheduleState — the only factory with no startDayOfWeek, since a single day has no week columns to align.

val state = rememberKalendarScheduleState(
    initialDate = today,
    minDate = LocalDate(2026, 1, 1),
    maxDate = LocalDate(2026, 12, 31),
)

How events are laid out#

eventColor tints the block's accent stripe and its fill (the fill at KalendarColors.eventBlockAlpha), falling back to KalendarColors.eventIndicator.

The grid scrolls to KalendarViewConfig.scheduleInitialScrollHour (7 by default) when a page first appears.

Drag to move and resize#

When onEventTimeChange is set, blocks become draggable:

• Press and hold, then drag — moves the whole event, preserving its duration.
• Press and hold the block's bottom edge, then drag — resizes it, moving only the end time. The grab strip is KalendarDimensions.eventBlockResizeHandleHeight (12.dp) tall.

Movement snaps to KalendarViewConfig.scheduleDragSnapMinutes (15 by default). A long press is required so an ordinary drag still scrolls the grid.

The callback fires on release with the event and its new start and end. The calendar never mutates events — update your own source:

var events by remember { mutableStateOf(initialEvents) }

KalendarSchedule(
    events = events,
    onEventTimeChange = { event, newStart, newEnd ->
        events = events.map { existing ->
            if (existing === event && existing is BasicKalendarEvent) {
                existing.copy(date = newStart.date, startTime = newStart, endTime = newEnd)
            } else {
                existing
            }
        }
    },
)

Warning: KalendarEvent is an interface with no copy — only the concrete implementation has one. Also remember to move date along with startTime: on KalendarScheduleWeek a horizontal drag can change the day, and newStart carries the shifted date. Dropping it would leave the event on its old date with a new time.

A drag that reaches the bottom of the day reports an end of 00:00 on the following date, since LocalTime cannot express 24:00. Handle that when you write the change back.

Theming#

Both Schedule views resolve everything through the ambient KalendarTheme:

To change the hour height for one calendar only, pass hourHeight; to change it everywhere, set KalendarDimensions.hourHeight on the theme.

The week variant#

KalendarScheduleWeek is the seven-day version: day columns sharing one hour gutter, with the same layout, drag, and theming behaviour.