elseware-icons
v1.0.1
Published
Original, cross-platform Elseware icons for React and React Native.
Maintainers
Readme
elseware-icons
Original, consistent SVG icons for React web and React Native applications.
Every icon supports solid, lite, and ghost appearances.
Install
npm install elseware-iconsReact Native and Expo applications also install the native SVG renderer:
npm install elseware-icons react-native-svgUse
import { HomeIcon } from "elseware-icons";
export function Example() {
return (
<>
<HomeIcon />
<HomeIcon appearance="solid" size={20} color="#7c3aed" />
<HomeIcon
appearance="lite"
color="#7c3aed"
secondaryColor="#a78bfa"
secondaryOpacity={0.2}
/>
</>
);
}For deterministic per-icon React Native bundles, use the direct entry point:
import { HomeIcon } from "elseware-icons/icons/home";ghost is the default appearance, size defaults to 24, and color defaults
to currentColor. Icons without an accessibilityLabel are decorative.
Browse the catalog
npm install
npm run devStorybook opens on http://localhost:6007. It includes search, category filters, appearance and color controls, direct-import copying, and visual QA matrices.
Development
Pull requests targeting main run the complete validation suite and verify
that the package version has not already been published. A successful merge to
main runs the same checks and publishes through GitHub's OIDC trusted
publishing; no long-lived npm token is stored in GitHub. Because this source
repository is private, npm provenance is disabled.
Configure npm Trusted Publishing for elseware-icons using repository
elsewaretechnology/elseware-icons, workflow publish.yml, and the GitHub
environment npm-production. Keep package.json and package-lock.json
synchronized and bump the version in the release PR:
npm version patch --no-git-tag-versionThe workflow fails when the exact version already exists on npm. If the
repository becomes public, remove --provenance=false to enable provenance.
npm run validate:icons
npm run generate
npm run validateCanonical art lives in assets/icons; generated React modules are committed
and checked in CI.
