Skip to content

Lineicons React Native: mobile-ready React Native SVG icons from Lineicons free & pro collections. Customize size, color, stroke, style — performance optimized.

Notifications You must be signed in to change notification settings

LineiconsHQ/lineicons-react-native

Repository files navigation

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-svg

or

yarn add @lineiconshq/react-native-lineicons @lineiconshq/free-icons react-native-svg

Peer Dependencies

Make sure you have the following installed:

npm install react-native-svg

iOS 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


🛠️ Development

Build Package

npm run build

Development Mode

npm run dev

📚 Resources & Support


⚖️ License

About

Lineicons React Native: mobile-ready React Native SVG icons from Lineicons free & pro collections. Customize size, color, stroke, style — performance optimized.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •