TableKMP is a highly customizable, deeply interactive, and buttery-smooth data grid / table library built natively for Compose Multiplatform.

Whether you need a simple list, a dense enterprise financial grid, or a fully interactive Kanban-style task board with drag-and-drop, TableKMP adapts perfectly across Desktop, Web, iOS, and Android.

• 📱 100% Multiplatform: Write once, run perfectly on Android, iOS, Desktop (JVM), and Web (Wasm/JS).
• 🖐️ Physics-Based Drag & Drop: Fluid, spring-animated row reordering with center-point collision and scroll-safe mechanics (items stay glued to the pointer even when using a mouse wheel).
• 🎨 Ultimate Customization: Inject any Composable into your cells. Support for avatars, progress bars, chips, and complex nested layouts.
• 🌗 Theming: Granular control over every color. Automatically cascades text/icon colors based on row selection.
• 📏 Responsive Design: Support for column weights alongside minWidth. Adapts beautifully to mobile screens while expanding gracefully on desktop monitors.
• ✅ Built-in Selection Engine: Native support for row selection with customizable checkboxes and sticky selection states.
• 📜 Smart Scrolling Tools: Custom draggable vertical and horizontal scrollbars for intense data grids.
• ⏳ Lifecycle States: Built-in support for isLoading views, onEmpty states, and custom footerContent.

TableKMP is designed to feature-match across all Compose Multiplatform targets.

Check out how TableKMP looks and feels across different scenarios.

1. Enterprise Financial Grid Dense data, horizontal scrolling, sticky selection, striped rows, and rich avatars.

2. Modern Admin Dashboard Clean user management dashboard with dark headers, pill badges, and action icons.

3. Dark Mode Analytics Fully inverted theme, borderless rows, hover highlighting, and status indicators.

4. Clean Users Directory Spacious rows, stacked text, custom pill coloring, and interactive action buttons.

5. Interactive Task Board Drag & Drop reordering enabled. Features row spacing, card elevations, and custom badges.

Add the dependency to your build.gradle.kts in the commonMain source set:

sourceSets {
    commonMain.dependencies {
        implementation("io.github.mamon-aburawi:table-kmp:{last_version}")

    }
}

TableKMP is designed to be incredibly intuitive. Define your columns, pass your data, and you're done.

data class User(val name: String, val role: String, val status: String)

val myUsers = listOf(
    User("Alice", "Admin", "Active"),
    User("Bob", "Contributor", "Pending")
)

@Composable
fun SimpleTable() {
    val columns = listOf(
        TableColumn<User>("Name", weight = 2f) { user -> Text(user.name, fontWeight = FontWeight.Bold) },
        TableColumn<User>("Role", weight = 1f) { user -> Text(user.role) },
        TableColumn<User>("Status", weight = 1f) { user  -> Text(user.status) }
    )

    Table(
        items = myUsers,
        columns = columns
    )
}

By utilizing TableConfig and TableColors, you can transform the table into a highly interactive dashboard.

var selectedUsers by remember { mutableStateOf(emptyList<User>()) }
var tableData by remember { mutableStateOf(myUsers) }

Table(
    items = tableData,
    columns = columns,
    onSelectionChanged = { selectedUsers = it },
    onItemsReordered = { tableData = it }, // Triggers when Drag & Drop completes
    config = TableConfig(
        dragDropEnabled = true,          // Enables physics-based reordering
        selectionEnabled = true,         // Shows checkboxes
        stripedEnabled = true,           // Alternating row colors
        rowShape = RoundedCornerShape(8.dp), // Rounded rows
        borderWidth = 1.dp               // Outlined borders
    ),
    colors = TableColors(
        headerContainerColor = Color(0xFF0F172A),
        headerContentColor = Color.White,
        selectedRowContainerColor = Color(0xFFEFF6FF),
        selectedRowContentColor = Color(0xFF3B82F6) // Automatically tints text/icons!
    )
)

Configuration for individual columns inside the table.

The primary entry point for rendering your data grid.

Controls the physical dimensions, toggles, and interaction behaviors of the table.

Granular control over the visual theme. Designed to work flawlessly with both Light and Dark modes.

Contributions, issues, and feature requests are welcome.

This project is licensed under the MIT License.