With the Image component, you can enhance the look and feel of your app or website by incorporating compelling imagery.
API Reference
Spec Doc
This is an illustration of Image component.
uri: "",


Step 1: Install the following dependencies:

npm i @gluestack-ui/image

Step 2: Copy and paste the following code into your project.

import React from "react"
import { createImage } from "@gluestack-ui/image"
import { Image as RNImage } from "react-native"
import { tva } from "@gluestack-ui/nativewind-utils"
import { cssInterop } from "nativewind"
const imageStyle = tva({
base: "max-w-full",
variants: {
size: {
"2xs": "h-6 w-6",
xs: "h-10 w-10",
sm: "h-16 w-16",
md: "h-20 w-20",
lg: "h-24 w-24",
xl: "h-32 w-32",
"2xl": "h-64 w-64",
full: "h-full w-full",
export const UIImage = createImage({ Root: RNImage })
const Image = ({ size = "md", className, ...props }: any) => {
return <UIImage className={imageStyle({ size, class: className })} />
cssInterop(UIImage, { className: "style" })
Image.displayName = "Image"
export { Image }

Step 3: Update the import paths to match your project setup.

API Reference

To use this component in your project, include the following import statement in your file.
import { Image } from "@/components/ui/Image"
export default () => <Image source={source} />

Component Props

This section provides a comprehensive reference list for the component props, detailing descriptions, properties, types, and default behavior for easy project integration.


It inherits all the properties of React Native's Image component.


Image component is created using Image component from react-native. It extends all the props supported by React Native Image.
Edit this page on GitHub