Linkees logo

Linkees

Elegant React link-in-bio page for showcasing social profiles

A sleek single‑page React app that lets creators display all their important social links in a customizable card layout, deployable to Vercel or Docker with minimal setup.

Linkees banner

Overview

Overview

Linkees is a single‑page React application designed for creators, freelancers, and anyone who wants a tidy hub for their social profiles. By supplying a simple JSON configuration of title, subtitle, URL and channel type, the component renders responsive cards that match the look of modern link‑in‑bio services while remaining fully customizable through React props such as name and headerAvatar.

Deployment

The library is published on npm and can be dropped into any React project with a single import. After adding your cardItems array, the app can be built and hosted on Vercel, Netlify, or any static‑site provider. For container‑based workflows, a Docker image is provided, enabling consistent builds across environments. Because the package is written in TypeScript, developers benefit from type safety and easy integration with existing toolchains.

Customization

Developers can extend the default card layout by passing custom React components or overriding the supplied CSS modules. The CHANNEL_TYPES enum supplies a set of common platforms (e.g., Instagram, Twitter, YouTube) and can be expanded to accommodate new services. Because the component is pure client‑side, it works without a backend, but it can be combined with analytics tools or serverless functions for link tracking if required.

Highlights

Simple JSON config for titles, subtitles, URLs, and channel types
Ready‑made React component with avatar and name props
Supports deployment on Vercel, Netlify, or Docker
Typed `CHANNEL_TYPES` enum for common social platforms

Pros

  • Easy integration with any React project
  • Lightweight and responsive out of the box
  • TypeScript support ensures type safety
  • Docker image enables consistent container deployments

Considerations

  • Limited to the React ecosystem
  • No built‑in analytics or link‑tracking
  • Deep visual customization requires CSS overrides
  • No backend; external services needed for advanced features

Managed products teams compare with

When teams consider Linkees, these hosted platforms usually appear on the same shortlist.

Beacons logo

Beacons

Link in bio & creator hub with store, email, and media kit

Bento logo

Bento

Personal profile and link-in-bio page builder that lets creators design a unified online presence easily

Bio.fm logo

Bio.fm

Link in bio that embeds videos, music, and social posts in rich blocks

Looking for a hosted option? These are the services engineering teams benchmark against before choosing open source.

Fit guide

Great for

  • Content creators needing a personal link hub
  • Freelancers showcasing portfolios and contact info
  • Small businesses wanting a simple social page
  • Event speakers who need a quick bio link page

Not ideal when

  • Enterprises requiring detailed analytics
  • Developers using non‑React frameworks
  • Projects that need server‑side rendering
  • Teams seeking multi‑language or i18n support out of the box

How teams use it

Personal link‑in‑bio page

Followers see a clean, mobile‑responsive list of social cards, increasing click‑through rates.

Freelance portfolio hub

Clients can quickly access contact, portfolio, and booking links from a single branded page.

Event speaker profile

Attendees get direct links to speaker socials, slides, and registration with minimal navigation.

Small business contact page

Customers find phone, email, and social media links in a unified, searchable interface.

Tech snapshot

TypeScript39%
JavaScript24%
CSS18%
HTML8%
Batchfile7%
Shell3%

Tags

linksvercellinktree-alternativehactoberfestreactlinktreedocker-imagetrendingdockerbio

Frequently asked questions

How do I install Linkees?

Run `npm install linkees` and import the component into your React project.

What format should my link configuration follow?

Provide an array of objects with `title`, `subtitle`, `link`, and `type` (using `CHANNEL_TYPES`).

Can I deploy the app with Docker?

Yes, a Dockerfile is included; build the image and run it on any container platform.

Is the component customizable?

You can pass custom avatars, change the `name` prop, and override CSS or supply your own card component.

Where can I contribute?

See the repository’s CONTRIBUTING guide on GitHub for documentation updates, feature requests, and code contributions.

Project at a glance

Active
Stars
383
Watchers
383
Forks
120
Repo age5 years old
Last commit2 months ago
Primary languageTypeScript

Last synced 12 hours ago