gluestack-ui is a universal UI library that provides optionally styled and accessible components. These components are designed for easy integration into applications developed with React and React Native.
You can find detailed documentation for each component, including a list of props and examples, in https://gluestack.io/ui/docs website.
-
Dynamic styles: Using JavaScript expressions, you can create dynamic styles that change based on the state of your components.
-
Server-side rendering (SSR) support: This allows you to use the same styles on the server and the client, making it easy to implement SSR for your React applications..
-
Responsive styling:: This allows you to easily create responsive styles that adapt to different screen sizes and resolutions.
-
Theme support: You can easily define and switch between different themes for your application, allowing for a consistent design across all pages.
-
Frequent updates: We are constantly working on improving the library and adding new components. Follow us on GitHub to stay up-to-date on the latest releases and features.
-
Community support: Need help using the library or have a suggestion for a new feature? Join our Discord channel to connect with the community and get support.
To use gluestack-ui components, all you need to install @gluestack-ui/themed and its dependencies
npm i @gluestack-ui/themed @gluestack-style/react react-native-svg@13.4.0JavaScript, React, React Native, Styled System
To use the gluestack-ui in your project, follow these steps:
- Wrap your application with the
GluestackUIProviderprovided by @gluestack-ui/themed.
import { GluestackUIProvider } from '@gluestack-ui/themed';
import { config } from '@gluestack-ui/config';
// Write this code snippet at the root of your application
function App({ children }) {
return <GluestackUIProvider config={config}>{children}</GluestackUIProvider>;
}- Now you can use
@gluestack-style/reactto style your components by using thestyledfunction provided by the library. For example:
import { Button, ButtonText } from '@gluestack-ui/themed';
const StyledButton = styled(
Pressable,
{
bg: '$red500',
p: '$3',
},
{}
);
const StyledButtonText = styled(Text, {}, {});
export const App = () => {
return (
<Button>
<ButtonText>Awesome Button!</ButtonText>
</Button>
);
};More guides on how to get started are available here.
We welcome contributions to the gluestack-ui. If you have an idea for a new component or a bug fix, please read our contributing guide instructions on how to submit a pull request.
Licensed under the MIT License, Copyright © 2023 GeekyAnts. See LICENSE for more information.