majiayu000 Pulse Mantine
Python bindings for Mantine React library. All components from @mantine/core, @mantine/form, @mantine/dates, and @mantine/charts are wrapped.
Quick Reference
from pulse_mantine import MantineProvider, Button, TextInput, Stack, Select
Adapting Mantine Docs to Pulse
Mantine docs use JSX. Convert to Pulse Python:
| JSX | Pulse Python |
|---|---|
<Button variant="outline">Click</Button> |
Button("Click", variant="outline") |
<Stack gap="md"><Item /></Stack> |
Stack(gap="md")[Item()] |
onClick={() => fn()} |
onClick=fn or onClick=lambda: fn() |
<Tabs.Tab value="x"> |
TabsTab("label", value="x") |
Key rules:
- Children as first args:
Button("text"),Title("heading") - Props use camelCase:
withAsterisk,onClick,defaultValue - Bracket syntax for nesting:
Stack()[child1, child2] - Compound components flatten:
Tabs.Tab→TabsTab,Modal.Body→ModalBody
Packages
Core (@mantine/core)
100+ UI components. All props from Mantine docs work directly.
Layout: Stack, Group, Grid, GridCol, Flex, Container, Center, AppShell Inputs: TextInput, Select, Checkbox, Switch, Slider, NumberInput, Textarea, PasswordInput, FileInput, ColorInput Buttons: Button, ActionIcon, CloseButton, CopyButton, FileButton Overlays: Modal, Drawer, Menu, Popover, Tooltip, HoverCard, Dialog Feedback: Alert, Notification, Progress, Loader, Skeleton Data Display: Card, Table, Accordion, Badge, Avatar, Timeline, Spoiler Navigation: Tabs, NavLink, Breadcrumbs, Pagination, Stepper Typography: Text, Title, Code, Highlight, List, Blockquote
Forms (@mantine/form)
Form state + client/server validation. See references/forms.md.
form = MantineForm(
initialValues={"email": ""},
validate={"email": IsEmail("Invalid email")},
)
return form.render(onSubmit=handle)[TextInput(name="email")]
Dates (@mantine/dates)
Date/time pickers. See references/dates.md.
DatePickerInput(name="date", label="Pick date")
DateTimePicker(name="datetime", label="Pick datetime")
TimeInput(name="time", label="Pick time")
Charts (@mantine/charts)
Recharts wrappers. See references/charts.md.
LineChart(h=300, data=data, dataKey="date", series=[{"name": "value", "color": "blue"}])
Common Patterns
Wrap app with provider:
@ps.component
def App():
return MantineProvider()[YourContent()]
Form with validation:
form = MantineForm(
initialValues={"name": "", "email": ""},
validate={
"name": IsNotEmpty("Required"),
"email": [IsNotEmpty("Required"), IsEmail("Invalid")],
},
validateInputOnBlur=True,
)
Modal/Drawer state:
with ps.init():
opened = ps.use_state(False)
Modal(opened=opened.value, opened.set(False))[content]
Notifications:
from pulse_mantine import Notifications, notifications
# Add <Notifications /> to layout
notifications.show(title="Success", message="Done", color="green")
Reference Files
For detailed API docs:
references/core.md- All core components by categoryreferences/forms.md- MantineForm, validators, form actionsreferences/dates.md- Date/time picker componentsreferences/charts.md- Chart components and data format