# @gluestack-ui/icon

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

Latest version **0.1.27** (published 2025-04-02) · 0 weekly downloads

## Install

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

## 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.27 |
| Published | 2025-04-02 |
| First published | 2023-02-21 |
| Weekly downloads | 0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 3 |
| Unpacked size | 24.2 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, icons, gluestack-ui, universal, headless, typescript, component, android, ios, nextjs |

## Links

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

## Dependencies (3)

- [@gluestack-ui/utils](https://npm.io/package/@gluestack-ui/utils.md) ^0.1.14
- [@gluestack-ui/provider](https://npm.io/package/@gluestack-ui/provider.md) ^0.1.19
- [@react-native-aria/focus](https://npm.io/package/@react-native-aria/focus.md) ^0.2.9

## Alternatives

- [@fortawesome/react-fontawesome](https://npm.io/package/@fortawesome/react-fontawesome.md) — 2.2M weekly downloads
- [roboto-fontface](https://npm.io/package/roboto-fontface.md) — 196.0K weekly downloads
- [@react-native-vector-icons/common](https://npm.io/package/@react-native-vector-icons/common.md) — 150.4K weekly downloads
- [@procore/core-icons](https://npm.io/package/@procore/core-icons.md) — 4.6K weekly downloads
- [@react-md/material-icons](https://npm.io/package/@react-md/material-icons.md) — 1.6K weekly downloads

## Recent versions

- 0.1.27 (latest) — 2025-04-02
- 0.1.24-alpha.0 (alpha) — 2024-11-19
- 0.1.26 — 2025-03-11
- 0.1.25 — 2024-12-03
- 0.1.23 — 2024-11-11
- 0.1.23-alpha.0 — 2024-11-07
- 0.1.22 — 2024-06-04
- 0.1.21 — 2024-05-08
- 0.1.20 — 2023-11-17
- 0.1.14-alpha.1 — 2023-11-17
- 0.1.14-alpha.0 — 2023-11-17
- 0.1.19 — 2023-11-15
- 0.1.18 — 2023-10-20
- 0.1.17 — 2023-10-19
- 0.1.16 — 2023-10-19
- … 19 more at https://npm.io/package/@gluestack-ui/icon/versions

## README

gluestack v5 is here!
Our biggest release yet is live today — with support for NativeWind v5 (Tailwind v4), optimized CLI performance, Expo Router first, and state-of-the-art native components.
# gluestack-ui: React Native & Expo Components & Patterns

gluestack-ui is a library of copy-pasteable components & patterns crafted with Tailwind CSS (NativeWind).

[![GitHub stars](https://img.shields.io/github/stars/gluestack/gluestack-ui)](https://github.com/gluestack/gluestack-ui)

[![NPM downloads](https://img.shields.io/npm/dw/@gluestack-ui/utils?logo=npm&label=NPM%20downloads&cacheSeconds=3600)](https://www.npmjs.com/package/@gluestack-ui/utils) [![Commits per month](https://img.shields.io/github/commit-activity/m/gluestack/gluestack-ui?label=Commits&logo=git)](https://github.com/gluestack/gluestack-ui/commits)

[![Expo Latest](https://github.com/gluestack/gluestack-ui/actions/workflows/expo-latest.yml/badge.svg)](https://github.com/gluestack/gluestack-ui/actions/workflows/expo-latest.yml)

<h3 align="center">
  <a href="https://github.com/gluestack/gluestack-ui">
    <img src="https://raw.githubusercontent.com/gluestack/gluestack-ui/main/apps/website/public/images/og-image.png" alt="gluestack-ui logo" >
  </a>
  <br>
  <br>
 </h3>

## Introduction

**gluestack-ui v5** offers customizable, beautifully designed components for your native projects. Unlike traditional libraries, it's not a pre-packaged dependency. Choose the components you need and copy-paste them directly into your Expo and React Native projects.

## Documentation

You can find detailed documentation for each component, including a list of props and examples, in https://gluestack.io/ui/docs website.

## Features

- **NativeWind v5 / Tailwind v4 Integration:** Tailwind CSS support for seamless styling across native platforms.
- **Modular Architecture:** Pick and choose the components you need without unnecessary bloat.
- **Expo Router First:** Out-of-the-box integration with the latest Expo Router.
- **Flexible Theming:** Customize your components with ease using theming tokens and configuration.
- **Accessibility:** Built with robust accessibility features to ensure inclusivity.
- **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](https://discord.com/invite/95qQ84nf6f) channel to connect with the community and get support.

## Installing **gluestack-ui v5**

To get started with **gluestack-ui v5**, you must have an existing Expo or React Native project. Then, simply run the following command:

```bash
npx gluestack-ui init
```

For detailed installation instructions, visit the [gluestack-ui v5 installation guide](https://gluestack.io/ui/docs/home/getting-started/installation).

## Tech Stack

TypeScript, React Native, Expo, Tailwind CSS, NativeWind

## Getting Started

- **Install gluestack-ui:** Follow the [installation guide](https://gluestack.io/ui/docs/home/getting-started/installation).
- **Add Components:** Use our CLI to add components to your project, or simply copy-paste from our documentation.
- **Customize:** Tailor the components to fit your project's needs using theming tokens and configuration.
- **Build:** Start building your app with a consistent, accessible, and high-performance UI.

## Migration from gluestack-ui v3 / v4

If you're migrating from earlier versions, check our [migration guide](https://gluestack.io/ui/docs) to upgrade to v5.

## Created By GeekyAnts

GeekyAnts is a team of React Native experts who love open-source and solving developer problems. We’ve been working on React Native since 2015 and have designed and built React Native apps for almost 200+ clients across the globe. Our clients include startups to big enterprises! Need help with your React Native app?

[Contact Us](https://geekyants.com/?utm_source=gluestack_github&utm_medium=read_me&utm_campaign=gluestack_integration)

## Contributing

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](./CONTRIBUTING.md) instructions on how to submit a pull request.

## License

Licensed under the MIT License, Copyright © 2026 GeekyAnts. See [LICENSE](https://github.com/gluestack/gluestack-ui/blob/main/LICENSE) for more information.

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