Skip to content

Ayushstark/Smart_Link

 
 

Repository files navigation

Smart Link Hub 🚀

The Context-Aware Link-in-Bio Platform.

A revolutionary open-source link management tool that adapts to your visitors' intent, context, and environment. Built with a focus on high-performance design, AI-driven personalization, and deep analytics.

🌟 Why Smart Link Hub?

Static link-in-bio pages are dead. They treat every visitor the same—whether they're a recruiter on a desktop at 2 PM or a friend on a mobile at 2 AM.

Smart Link Hub solves this by dynamically reordering and highlighting content based on Intent, Context, and Rules.


🎨 5 Distinct Visual Universes

We don't just do "themes"; we do fully immersive visual systems.

  1. Neo-Brutalism: Implemented with high-contrast Green & Black (#4ADE80), massive animated typography, isometric hover effects. Aggressive and bold.
  2. Claymorphism: Features soft, matte, inflated 3D surfaces with "squishy" physics (scale down on hover) and deep shadows. Playful and tactile.
  3. Liquid Glass: Achieved through organic morphing border-radii, "wet" specular highlights, and fluid transitions. Modern and sleek.
  4. Skeuomorphism: Realistic dark brushed metal/carbon textures, physical press animations, and LED indicators. Retro-future industrial.
  5. Glassmorphism: Clean, futuristic frosted glass with green auras and parallax background effects. Elegant and minimal.

Note: All themes strictly enforce a Green & Black palette for brand consistency.


🧠 Core Features

1. Intelligent Intent-Based Routing

  • Visitor Splash Screen: Prompts visitors to identify who they are (e.g., "Recruiter", "Peer", "Lead").
  • Dynamic Sorting: Instantly reorders the link hierarchy based on selection. Recruiters see your GitHub/LinkedIn first; Peers see your Socials/Spotify.

2. Smart Rules Engine

Create granular rules to control link visibility and order:

  • Device Rules: Target iOS vs. Android, Desktop vs. Mobile.
  • Time Rules: Schedule links (e.g., "Show Twitch only on weekends").
  • Location Rules: Geo-tag links (e.g., "Show local events only to users in India").
  • Performance Rules: Auto-promote high-CTR links.

3. Hybrid AI "Magic Rule" ✨

Describe your logic in plain English, and our AI agent handles the rest.

  • "Promote my Spotify playlist on weekends for mobile users in New York" -> AI generates the complex rule JSON automatically.
  • Powered by Groq (Llama 3) for speed and Google Gemini 1.5 for complex reasoning.

4. Drag-and-Drop Management

  • Full drag-and-drop interface for manual link organization.
  • Optimistic UI updates for zero-latency feel.

5. Deep Analytics

  • Track Visits, Clicks, CTR, and Link Performance history.
  • Visualize trends with interactive charts.
  • Export data capabilities.

6. QR Code Studio

  • Generate and customize QR codes for your public hub.

🛠️ Tech Stack

  • Frontend: Next.js 14 (App Router), TailwindCSS, Framer Motion, @dnd-kit, lucide-react.
  • Backend: Node.js, Express, Prisma ORM.
  • Database: PostgreSQL (via Supabase/Neon).
  • AI: Groq SDK, Google Generative AI SDK, Vercel AI SDK.
  • Architecture: TurboRepo Monorepo (apps/web, apps/api, packages/shared).

🚧 Known Flaws & Limitations

  • Performance: The "Liquid Glass" and particle effects are GPU-intensive. Older devices may experience frame drops. useReducedMotion is implemented but default effects are strong.
  • Intent Splash Customization: Currently requires direct DB edits to change the "Recruiter/Peer" options distribution. UI for this is pending.
  • Backend Monolith: Analytics and core logic live in the same Node.js service. Heavy traffic spikes might require easier decoupling (e.g., Microservices with ClickHouse/Redis).

🗺️ Roadmap & Future

  • Client-Side Intelligence: Battery-saver mode (auto-switch to OLED Black theme on low battery).
  • Real-Life Integrations: Helper integrations (e.g., Hide "Book Meeting" if Google Calendar is busy; Match theme to current Spotify track).
  • Conversational Resume: AI Chat bubble on your profile to answer recruiter questions interactively.
  • Redis Caching: Edge caching for public hub API endpoints to handle viral traffic.
  • A/B Testing Auto-Pilot: AI that automatically rotates link headlines/orders to maximize CTR.

Built with 💚 by Mohit.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 95.1%
  • CSS 4.4%
  • Other 0.5%