# @gluestack-ui/image

> A universal headless Button component for React Native, Next.js & React

Latest version **0.1.17** (published 2025-03-11) · 0 weekly downloads

## Install

```sh
npm install @gluestack-ui/image
pnpm add @gluestack-ui/image
yarn add @gluestack-ui/image
bun add @gluestack-ui/image
```

## Health

**Score 50/100 (C)** — status: stable.

Positive: has types; esm support; no vulnerabilities; high maintenance score.

Warnings: low downloads; pre 1.0.

Negative: stale.

## Facts

| | |
|---|---|
| Version | 0.1.17 |
| Published | 2025-03-11 |
| First published | 2023-06-05 |
| Weekly downloads | 0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 3 |
| Unpacked size | 7.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 5308 |
| Maintainers | vidhi499, rohit_singh, viraj-10, rayan1810, rajat693, surajahmedc, meenumakkar, madhavb230100, vaibhk002, daminipandey, amars29, geekgautam, sravankumarvelangi, gluestackadmin, geekashwini, mayankp06 |
| Keywords | react, native, react-native, button, gluestack-ui, universal, headless, typescript, component, android, ios, nextjs |

## Links

- npm: https://www.npmjs.com/package/@gluestack-ui/image
- Repository: https://github.com/gluestack/gluestack-ui
- Homepage: https://github.com/gluestack/gluestack-ui/tree/main/packages/unstyled/image#readme
- Issues: https://github.com/gluestack/gluestack-ui/issues
- npm.io page: https://npm.io/package/@gluestack-ui/image

## Dependencies (3)

- [@gluestack-ui/utils](https://npm.io/package/@gluestack-ui/utils.md) ^0.1.15
- [@react-native-aria/focus](https://npm.io/package/@react-native-aria/focus.md) ^0.2.9
- [@react-native-aria/interactions](https://npm.io/package/@react-native-aria/interactions.md) 0.2.16

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 0.1.17 (latest) — 2025-03-11
- 0.1.0-alpha.7 (alpha) — 2023-09-15
- 0.1.16 — 2025-03-03
- 0.1.15 — 2025-02-19
- 0.1.14 — 2025-02-18
- 0.1.13 — 2025-02-18
- 0.1.12 — 2025-02-18
- 0.1.11 — 2024-11-11
- 0.1.10 — 2024-07-08
- 0.1.9 — 2024-03-21
- 0.1.8 — 2024-03-18
- 0.1.7 — 2023-11-15
- 0.1.6 — 2023-10-20
- 0.1.5 — 2023-10-19
- 0.1.4 — 2023-10-19
- … 9 more at https://npm.io/package/@gluestack-ui/image/versions

## README

# @gluestack-ui/image

## Installation

To use `@gluestack-ui/image`, all you need to do is install the
`@gluestack-ui/image` package:

```sh
$ yarn add @gluestack-ui/image

# or

$ npm i @gluestack-ui/image
```

## Usage

A image component is a graphical user interface element that enables users to act by clicking or tapping. It can be customized in size, shape, color, and behavior to fit the design of the application or website. Here's an example how to use this package to create one:

```jsx
import { createImage } from '@gluestack-ui/image';
import { Root } from './styled-components';

export const Image = createImage({
  Root,
});
```

## Customizing the Image:

Default styling of all these components can be found in the components/core/image file. For reference, you can view the [source code](https://github.com/gluestack/gluestack-ui/blob/development/example/storybook/src/ui-components/Image/index.tsx) of the styled `Image` components.

```jsx
// import the styles
import { Root } from '../components/core/image/styled-components';

// import the createImage function
import { createImage } from '@gluestack-ui/image';

// Understanding the API
const Image = createImage({
  Root,
});

// Using the image component
export default () => <Image />;
```

More guides on how to get started are available
[here](https://ui.gluestack.io/docs/components/forms/image).

---
_Source: https://npm.io/package/@gluestack-ui/image · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._