@lineiconshq/react-native-lineicons
v0.0.3
Published
React Native components for LineIcons - Free and Pro icon library
Readme
React Native Package for Lineicons — Essential UI Icons for React Native
Lineicons React Native provides lightweight, fully customizable SVG icons as React Native components. Easily use Free or Pro icons in your mobile apps with support for size, color, stroke width, and styling.
✨ Features
- 🎨 Multiple Styles — Stroke, Solid, Duotone, Bulk, and Outlined icons
- 📱 React Native Ready — Optimized for mobile performance
- 🧩 Customizable — Control size, color, stroke width, and styles
- 🚀 Tree Shaking — Only bundle the icons you use
- 🧑💻 TypeScript Support — Full type definitions included
- 📦 Lightweight — Minimal bundle size impact
📦 Installation
npm install @lineiconshq/react-native-lineicons @lineiconshq/free-icons react-native-svgor
yarn add @lineiconshq/react-native-lineicons @lineiconshq/free-icons react-native-svgPeer Dependencies
Make sure you have the following installed:
npm install react-native-svgiOS Setup (React Native CLI)
If you’re using React Native CLI (not Expo), install iOS pods:
cd ios && pod install🚀 Usage
Basic Example
import { Lineicons } from '@lineiconshq/react-native-lineicons';
import { Search1Stroke } from '@lineiconshq/free-icons';
export default function App() {
return (
<Lineicons
icon={Search1Stroke}
size={24}
color="#000000"
strokeWidth={2} // Only for stroke icons
/>
);
}Advanced Customization
import { Lineicons } from '@lineiconshq/react-native-lineicons';
import { Aeroplane1Stroke } from '@lineiconshq/free-icons';
export default function CustomIcon() {
return (
<Lineicons
icon={Aeroplane1Stroke}
size={48}
color="#007AFF"
strokeWidth={2.5}
style={{
shadowColor: '#000',
shadowOffset: { width: 0, height: 2 },
shadowOpacity: 0.25,
shadowRadius: 3.84,
elevation: 5,
}}
opacity={0.8}
// All other react-native-svg Svg props are supported
/>
);
}📚 Props
| Prop | Type | Default | Description |
| --------------- | ------------------ | -------------- | ------------------------------------------------ |
| icon | IconData | — (required) | Icon object containing SVG path data. |
| size | number \| string | 24 | Icon size (pixels or percentages). |
| color | string | currentColor | Icon color (hex, rgb, or named colors). |
| strokeWidth | number | 1.5 | Stroke width (only for stroke icons). |
| style | ViewStyle | — | Additional React Native styles. |
| ...otherProps | SvgProps | — | All other props supported by react-native-svg. |
🔧 Requirements
- React Native ≥ 0.60.0
- React ≥ 16.8.0
- react-native-svg ≥ 12.0.0
📱 Platform Support
- ✅ iOS
- ✅ Android
- ✅ Web (via react-native-web)
🛠️ Development
Build Package
npm run buildDevelopment Mode
npm run dev📚 Resources & Support
⚖️ License
- Free Icons: MIT License
