Skip to main content

Changelog

All notable changes to LinkForty will be documented here.

Recent Updates​

March 2024​

Webhooks Management​

  • ✅ Create, list, update, and delete webhooks via dashboard and API
  • ✅ HMAC SHA-256 signature verification for security
  • ✅ Event types: click_event, install_event, conversion_event
  • ✅ Automatic retry with exponential backoff
  • ✅ Webhook delivery logs and status tracking
  • ✅ Test webhook endpoint for validation

Team & Organization Features​

  • ✅ Multi-organization support for agencies and teams
  • ✅ Role-based access control (Owner, Admin, Member, Viewer)
  • ✅ Team invitation system with 7-day expiration
  • ✅ Organization switching with JWT context
  • ✅ Usage tracking and plan limits per organization
  • ✅ Organization transfer ownership capability

Projects​

  • ✅ Project-based link organization
  • ✅ Project analytics with aggregated metrics
  • ✅ Filter links by project
  • ✅ Bulk assign links to projects

Analytics Enhancements​

  • ✅ Organization-wide analytics dashboard
  • ✅ Geographic analytics (country, city, region, timezone)
  • ✅ Device and platform breakdowns
  • ✅ Traffic source tracking (UTM parameters, referrers)
  • ✅ Time-based analytics (clicks by hour, date)
  • ✅ Top performing links tracking
  • ✅ Recent activity stream
  • ✅ Analytics data export (JSON and CSV)
  • ✅ Bulk operations (create, update, delete up to 100 links)
  • ✅ Link templates for rapid creation
  • ✅ QR code generation for links
  • ✅ Link expiration support
  • ✅ Link activation/deactivation toggle
  • ✅ UTM parameter management

Mobile Attribution​

  • ✅ Deferred deep linking support
  • ✅ Configurable attribution windows (1-168 hours)
  • ✅ Device fingerprinting for attribution
  • ✅ React Native SDK for mobile integration
  • ✅ iOS and Android platform detection

February 2024​

Core Features​

  • ✅ Custom domain support with SSL verification
  • ✅ API key management for programmatic access
  • ✅ Rate limiting protection
  • ✅ Redis caching for improved performance
  • ✅ Click event geolocation tracking

Developer Experience​

  • ✅ Comprehensive API documentation
  • ✅ TypeScript support throughout
  • ✅ Docker Compose for local development
  • ✅ Database migration system
  • ✅ Environment variable configuration

January 2024​

Initial Release​

  • ✅ Link shortening with custom short codes
  • ✅ Platform-specific redirects (iOS, Android, Web)
  • ✅ Click tracking and analytics
  • ✅ User authentication and authorization
  • ✅ Dashboard UI with React and TanStack Query
  • ✅ RESTful API with Fastify
  • ✅ PostgreSQL database with connection pooling
  • ✅ Docker deployment support

Upcoming Features​

Q2 2024 Roadmap​

Advanced Analytics:

  • 📋 Campaign performance comparison
  • 📋 Conversion funnel visualization
  • 📋 Custom analytics date ranges
  • 📋 Scheduled analytics reports

Team Collaboration:

  • 📋 Activity audit logs (Enterprise)
  • 📋 2FA enforcement for teams (Enterprise)
  • 📋 IP whitelisting (Enterprise)
  • 📋 Team member activity tracking

Link Features:

  • 📋 A/B testing for links
  • 📋 Link cloaking options
  • 📋 Password-protected links
  • 📋 Geo-targeting rules
  • 📋 Device-specific targeting

Integration:

  • 📋 Zapier integration
  • 📋 Slack notifications
  • 📋 Google Analytics integration
  • 📋 Meta Pixel integration

Developer Tools:

  • 📋 iOS Native SDK
  • 📋 Android Native SDK
  • 📋 Flutter SDK
  • 📋 GraphQL API option

Breaking Changes​

None Yet​

This project is in active development. Breaking changes will be clearly documented here with migration guides when they occur.

Migration Guides​

Future Migrations​

Migration guides will be added here when version upgrades require code changes.

Deprecations​

None Yet​

Deprecated features will be listed here with sunset timelines and recommended alternatives.

Security Updates​

March 2024​

  • Webhook HMAC Verification: All webhook deliveries now include HMAC SHA-256 signatures for authenticity verification
  • Role-Based Access Control: Comprehensive RBAC system prevents unauthorized access to organization resources
  • JWT Context: Organization context embedded in JWT tokens for secure multi-tenant support

February 2024​

  • API Key Rotation: Support for creating and revoking API keys
  • Rate Limiting: Protection against abuse with configurable rate limits
  • Custom Domain Verification: SSL verification for custom domains

Performance Improvements​

March 2024​

  • Redis Caching: 5-minute TTL on link lookups reduces database load by ~80%
  • Asynchronous Click Logging: Click events logged asynchronously to avoid blocking redirects
  • Database Indexing: Optimized indexes on frequently queried columns

February 2024​

  • Connection Pooling: PostgreSQL connection pool with retry logic
  • Query Optimization: Reduced N+1 queries in analytics endpoints
  • Static Asset Caching: CDN-ready frontend build with cache headers

Bug Fixes​

March 2024​

  • Fixed: Organization member count not updating after invitation acceptance
  • Fixed: QR code cache not invalidating when link URL changes
  • Fixed: Timezone inconsistency in analytics date grouping
  • Fixed: Webhook retry not respecting exponential backoff cap

February 2024​

  • Fixed: Short code collision when creating links simultaneously
  • Fixed: Geolocation data missing for some IP addresses
  • Fixed: UTM parameters not properly URL-encoded in redirects
  • Fixed: Link expiration not checking timezone

Documentation Updates​

March 2024​

  • ✅ Complete API reference for all endpoints
  • ✅ Webhooks integration guide with code examples
  • ✅ Organizations and team management guides
  • ✅ Roles and permissions documentation
  • ✅ Team invitations workflow guide
  • ✅ Projects organization guide
  • ✅ Analytics dashboard guide
  • ✅ React Native SDK documentation
  • ✅ Deferred deep linking guide
  • ✅ Attribution windows configuration

February 2024​

  • ✅ Getting started guide
  • ✅ Self-hosting documentation
  • ✅ Cloud vs self-hosted comparison
  • ✅ Link creation guide
  • ✅ UTM parameters guide
  • ✅ QR codes guide
  • ✅ Link templates guide

Community​

Get Involved​

  • GitHub: linkforty/linkforty
  • Issues: Report bugs and request features on GitHub Issues
  • Discussions: Join community discussions on GitHub Discussions

Contributors​

Thank you to everyone who has contributed to LinkForty!

  • Code contributions
  • Documentation improvements
  • Bug reports and feature requests
  • Community support

Support​

Getting Help​

Version History​

  • v1.x.x - Current release (see above for details)
  • v0.x.x - Beta releases (January 2024)

Acknowledgments​

LinkForty is built with these amazing open-source projects:

Backend:

  • Fastify - Fast and low overhead web framework
  • PostgreSQL - Powerful open-source database
  • Redis - In-memory data structure store
  • nanoid - Unique ID generator
  • zod - TypeScript-first schema validation

Frontend:

  • React - UI library
  • Vite - Next generation frontend tooling
  • TanStack Query - Data fetching and caching
  • TanStack Table - Headless table library
  • Tailwind CSS - Utility-first CSS framework
  • Recharts - Composable charting library

Infrastructure:

  • Docker - Containerization platform
  • Node.js - JavaScript runtime

License​

LinkForty is available under the MIT License.

See LICENSE for details.

Last Updated: March 2024

Stay updated by watching our GitHub repository for releases.