Liberty Core is a reusable component library designed for React applications. It provides a collection of UI components, utilities, and styles to streamline development. This package includes pre-styled components, utility functions, and common types, making it an essential part of the Liberty Framework. This repository contains an application for testing all components and how to use them
- 🎨 Theme & Styling: Centralized theme management.
- 🏗️ Prebuilt UI Components: Includes buttons, dialogs, typography, tables, alerts, and more.
- ⚙️ Utility Functions: Common helper functions for improved developer experience.
- 🛠️ Type Definitions: Predefined TypeScript types for consistent data handling.
- 🔌 Easy Integration: Works seamlessly with any React project.
To install Liberty Core, run the following command:
npm install liberty-core
or with Yarn:
yarn add liberty-core
You can import and use any component from Liberty Core directly in your React app:
import { Button, Dialog, Alert } from "liberty-core";
const App = () => {
return (
<div>
<Alert variant="success">This is a success alert!</Alert>
<Button onClick={() => console.log("Clicked!")}>Click Me</Button>
<Dialog title="Example Dialog">This is a sample dialog.</Dialog>
</div>
);
};
export default App;
Liberty Core provides a customizable theme. Wrap your application in a ThemeProvider
to apply the default or custom theme:
import { ThemeProvider, theme } from "liberty-core";
const App = () => {
return (
<ThemeProvider theme={theme}>
<YourAppComponents />
</ThemeProvider>
);
};
Liberty Core includes common utility functions that can be used across your application:
import { formatDate } from "liberty-core";
const date = formatDate(new Date());
console.log(date); // Output: Formatted date
Liberty Core exports various components categorized as styles, common components, and utilities.
import {
theme, icons, Button, Dialog, Div, IconButton, Main, Menus, Paper, Stack, Typography
} from "liberty-core";
import {
Alert, AlertMessage, Button, Card, Checkbox, CircularProgress, Collapse,
ConfirmationDialog, Dialog, Divider, Flex, FlexAdvanced, Grid, IconButton,
Input, List, LoadingIndicator, MarkDown, Menus, Popper, Select, Skeleton,
SnackMessage, Tab, Table, Toggle, Tooltip, Tree, Typography, UseMediaQuery
} from "liberty-core";
import { commonUtils } from "liberty-core";
import { commonTypes } from "liberty-core";
liberty-core is open-source software licensed under the AGPL License.
Copyright (c) 2025 NOMANA-IT and/or its affiliates.
All rights reserved. Use is subject to license terms.
If you have questions or need support:
- Email: [email protected]
- GitHub Issues: Report an issue
- Discussions: Join the conversation in the GitHub Discussions section.
git clone https://github.com/fblettner/liberty-core.git
cd liberty-core
If you find Liberty Core useful and would like to support its development, consider sponsoring us. Your contributions help maintain the project, add new features, and improve the documentation. Every contribution, big or small, is greatly appreciated!
To sponsor, visit: GitHub Sponsors or reach out to us directly.