LibreLinks

Table of Contents

This is a list of all the sections in this post. Click on any of them to jump to that section.

Next.js React JavaScript TailwindCSS MongoDB Prisma

LibreLinks is an open-source link in bio tool for everyone. Create and customize your link in bio page in minutes and connect with your audience through a single link.

✨ Core Features

1. Customize Your Page

Easily customize your page with beautiful themes and color palettes. Make your profile uniquely yours with a variety of design options.

2. Keep Track of Everything

Get useful insights on your profile including:

  • Number of views and clicks
  • Visitor countries and locations
  • Device types and browsers
  • Traffic sources and trends

Share your profile everywhere with just one unique link tailor-made for you. Perfect for social media bios, email signatures, and more.

4. Privacy Centered

All your links belong to you. We do not sell your data or compromise your privacy.

πŸ› οΈ Tech Stack

  • Next.js 13 - Web framework with SSG support and SEO optimization
  • React - UI library with declarative, component-based architecture
  • JavaScript - Programming language for web development
  • Tailwind CSS - Utility-first CSS framework for rapid styling
  • MongoDB - NoSQL database with JSON-like documents
  • Prisma - Modern database toolkit and ORM
  • Tinybird - Real-time analytics platform for data insights
  • NextAuth.js - Authentication solution with Google OAuth support

🎯 Key Highlights

Open Source

LibreLinks is completely open source and welcomes contributions from the community. Built with transparency and collaboration in mind.

Fast & Responsive

Built with Next.js for optimal performance and React for reactive, reusable components. Pages load quickly and work seamlessly across all devices.

Easy Authentication

Simple sign-in with Google OAuth integration powered by NextAuth.js.

Real-time Analytics

Track your profile performance with real-time analytics powered by Tinybird, giving you instant insights into your audience.

πŸ“ Project Structure

RouteDescription
/Home page/landing page
/adminUser dashboard and playground
/loginAuthentication page
/registerUser registration page
/admin/[page]Individual customization pages
/[username]Public profile pages

πŸš€ Getting Started

Prerequisites

  • Node.js (v14 or higher)
  • MongoDB database
  • Google OAuth credentials

Environment Variables

Create a .env file with the following variables:

DATABASE_URL=your_mongodb_connection_string
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
NODE_ENV=development
NEXTAUTH_JWT_SECRET=your_jwt_secret
NEXTAUTH_SECRET=your_nextauth_secret

Installation

  1. Clone the Repository

    git clone https://github.com/urdadx/librelinks.git
    cd librelinks
  2. Install Dependencies

    npm install
  3. Start Development Server

    npm run dev
  4. Open Your Browser Navigate to http://localhost:3000 to see LibreLinks live

🎨 Use Cases

  • Social Media Influencers - Centralize all your social links in one place
  • Content Creators - Share your latest content, merch, and platforms
  • Musicians & Artists - Link to streaming platforms, tickets, and portfolio
  • Businesses - Connect customers to products, services, and contact info
  • Personal Branding - Create a professional digital presence

🀝 Contributing

We love our contributors! Here’s how you can contribute:

  • Open an issue if you believe you’ve encountered a bug
  • Make a pull request to add new features, improve quality of life, or fix bugs
  • Share feedback and suggestions for improvements

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

🌟 Community

Join the growing community of LibreLinks users and contributors. Star the repository to show your support!