v0.4.4

What's Changed

• feat(docs): scaffold fumadocs site with API reference by @azizbecha in #10

Full Changelog: v0.4.3...v0.4.4

v0.4.3

What's Changed

• chore: restructure monorepo to packages/ + pnpm 10 by @azizbecha in #9
• fix(LinkPreview): avoid render loop on persistent errors (release 0.4.3) by @azizbecha in #11

Full Changelog: v0.4.2...v0.4.3

v0.4.2

Full Changelog: v0.4.1...v0.4.2

v0.4.1

What's Changed

• ci: simplify release flow to bump-and-push by @azizbecha in #5
• fix(ci): drop registry-url so npm publish uses OIDC by @azizbecha in #6
• fix(ci): upgrade npm to 11+ for OIDC trusted publisher auth by @azizbecha in #7

Full Changelog: v0.4.0...v0.4.1

v0.4.0

What's Changed

• harden: timeouts cache a11y by @azizbecha in #1
• chore: migrate to oxc by @azizbecha in #2
• fix(ci): unblock test --coverage and expo web export by @azizbecha in #3
• ci: add tag-triggered release workflow with npm trusted publisher by @azizbecha in #4

Full Changelog: v0.3.0...v0.4.0

v0.1.0

🎉 v1.0.0 — First Public Release

We’re excited to announce the first public release of react-native-preview-url 🚀 — a React Native library for displaying rich link previews using our free open-source Link Preview API.

✨ Features

<LinkPreview /> Component — display link previews with customizable styles and layout.

useUrlPreview Hook — fetch and manage preview metadata easily in functional components.

Customizable UI with style overrides and behavior props.

Free API usage — no API key required.

📋 Props

This release supports the following props for <LinkPreview />:

url (string, required) — The URL to preview.

timeout (number) — Request timeout in milliseconds, default is 3000.

onSuccess (function) — Callback when metadata is fetched successfully. Receives the metadata object.

onError (function) — Callback when an error occurs. Receives the error message.

onPress (function) — Press handler for the whole preview. Defaults to opening the fetched data.url.

containerStyle (ViewStyle) — Custom style for the main container.

imageStyle (ImageStyle) — Custom style for the preview image.

imageContainerStyle (ViewStyle) — Custom style for the image wrapper.

titleStyle (TextStyle) — Custom style for the title text.

descriptionStyle (TextStyle) — Custom style for the description text.

urlStyle (TextStyle) — Custom style for the displayed domain text.

titleLines (number) — Maximum number of lines for the title. Default: 2.

descriptionLines (number) — Maximum number of lines for the description. Default: 4.

showUrl (boolean) — Whether to display the domain under the description. Default: true.

hideImage (boolean) — Whether to hide the image preview entirely. Default: false.

loaderComponent (JSX element) — Custom loader component while fetching metadata. Defaults to .

imageComponent (React component) — Custom image component to render. Defaults to .

fallbackImage (ImageSourcePropType) — Fallback image URL to use if the preview image fails to load.