🚀 A powerful, enterprise-grade URL shortener built with .NET 9 and modern web technologies
Transform long URLs into powerful, trackable short links with comprehensive analytics and beautiful admin interface
🎯 Quick Start • 📊 Features • 🛠️ Tech Stack • 📖 Documentation • 🚀 Deploy
Try the live demo: ScissorLink live demo — lnk.apponline.ir
✨ Cut long URLs down to size with style and intelligence
🔥 Major Architecture Overhaul - Click to expand
- ✅ Namespace Evolution → Migrated from legacy
akhr.irto meaningfulScissorLinknamespace - ✅ ORM Revolution → Completely replaced Dapper with Entity Framework Core for enhanced maintainability
- ✅ React Transformation → Brand new Material-UI admin panel for comprehensive link management
- ✅ Full-Stack Harmony → Seamless API integration between .NET backend and React frontend
- ✅ Design Excellence → Google Material Design standards throughout the admin interface
- ✅ Mobile-First → Responsive design with modern UI/UX patterns
- ✅ .NET 9 Upgrade → Latest LTS version with 40% improved performance
- ✅ Clean Architecture → Dependency injection and SOLID principles implementation
- ✅ Advanced Analytics → Enhanced click tracking with detailed visitor insights
- ✅ Smart Testing → Domain-agnostic test buttons for any deployment environment
- ✅ Error Excellence → Modern middleware with detailed logging and user-friendly messages
|
|
🚀 Backend Powerhouse
|
⚛️ Frontend Excellence
|
🗄️ Database & Storage
|
| Requirement | Version | Download Link |
|---|---|---|
| 🔧 .NET SDK | 9.0+ | Download .NET |
| 📦 Node.js | 18.0+ | Download Node.js |
| 🗄️ SQL Server | 2016+ | Download SQL Server |
| 💻 IDE | VS Code / VS 2022 | VS Code | Visual Studio |
All tools are free and cross-platform compatible
🪟 Windows Users - Click here
# 🚀 One-click startup (Run as Administrator if needed)
./start-dev.bat⚡ PowerShell Users - Click here
# 🔥 PowerShell magic
# Set execution policy if needed: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
./start-dev.ps1🎉 This automatically starts:
| Service | URL | Purpose |
|---|---|---|
| 🔧 Backend API | http://localhost:5000 |
Core URL shortening engine |
| ⚛️ Admin Dashboard | http://localhost:3000 |
Beautiful React management UI |
Run the Script.sql in your SQL Server database to create the required tables:
ShortLink- Main URL data with enhanced schemaShortLinkDetail- Analytics and visitor tracking
Edit the connection string in src/appsettings.json:
{
"ConnectionStrings": {
"dbScissorLink": "Server=localhost;Database=dbScissorLink;User Id=myUser;Password=MyPass;Encrypt=false;TrustServerCertificate=true;Connection Timeout=30;"
}
}cd src
dotnet restore
dotnet runAPI will be available at http://localhost:5000
cd client
npm install
npm startAdmin interface will be available at http://localhost:3000
ScissorLink/
├── ScissorLink.Controllers/ # API controllers and endpoints
├── ScissorLink.Services/ # Business logic and caching
├── ScissorLink.Repos/ # Data access with Entity Framework
├── ScissorLink.Models/ # Entity Framework models
├── ScissorLink.DTOs/ # Data Transfer Objects for API
├── ScissorLink.Data/ # DbContext and database configuration
├── ScissorLink.Common/ # Shared utilities and middleware
└── ScissorLink.UserAgent/ # Browser and OS detection
src/
├── Controllers/
│ ├── AdminController.cs # Admin API endpoints (CRUD)
│ ├── ProcessController.cs # URL redirection and analytics
│ └── ErrorController.cs # Error handling
├── Data/
│ └── ScissorLinkDbContext.cs # Entity Framework DbContext
├── DTOs/ # API Data Transfer Objects
│ ├── ShortLinkRequestDto.cs
│ ├── ShortLinkResponseDto.cs
│ └── ShortLinkDetailDto.cs
├── Models/ # Entity Framework Models
│ ├── DtoShortLink.cs
│ ├── DtoShortLinkDetail.cs
│ └── DtoResult.cs
├── Services/ # Business Logic
│ ├── ProcessService.cs
│ └── Interface/
│ └── IProcessService.cs
├── Repos/ # Data Access Layer
│ ├── ProcessRepo.cs
│ ├── BaseRepo.cs
│ └── Interface/
│ └── IProcessRepo.cs
├── Common/ # Shared Components
│ └── ErrorHandlingMiddleware.cs
├── UserAgent/ # Device Detection
│ ├── UserAgent.cs
│ ├── ClientBrowser.cs
│ ├── ClientOS.cs
│ └── MatchExpression.cs
└── wwwroot/ # Static Files
└── GeoLite2-Country.mmdb
client/
├── public/
│ └── index.html # Main HTML template
├── src/
│ ├── components/
│ │ ├── AddShortLinkDialog.tsx # Add new link dialog
│ │ └── ShortLinksList.tsx # Links list with actions
│ ├── pages/
│ │ └── ShortLinksPage.tsx # Main admin page
│ ├── services/
│ │ └── apiService.ts # API communication layer
│ ├── types/
│ │ └── api.ts # TypeScript type definitions
│ ├── App.tsx # Main React component
│ └── index.tsx # Application entry point
└── package.json
| Method | Endpoint | Description | Request Body |
|---|---|---|---|
GET |
/shortlinks |
Get all short links | - |
GET |
/shortlinks/{id} |
Get specific short link | - |
POST |
/shortlinks |
Create new short link | ShortLinkRequestDto |
PUT |
/shortlinks/{id} |
Update short link | ShortLinkRequestDto |
DELETE |
/shortlinks/{id} |
Delete short link | - |
POST |
/shortlinks/{id}/toggle-publish |
Toggle publish status | - |
| Method | Endpoint | Description |
|---|---|---|
GET |
/{token} |
Redirect to original URL and track analytics |
{
title?: string; // Optional friendly name
token?: string; // Custom token (auto-generated if empty)
originLink: string; // Target URL (required)
isPublish: boolean; // Publish status
}{
id: number;
title?: string;
token: string;
originLink: string;
isPublish: boolean;
createAdminDate: string;
editAdminDate?: string;
clickCount: number;
recentClicks: ShortLinkDetailDto[];
}- 📋 List View - Paginated display with search and filtering
- ➕ Add New - Modal dialog with real-time validation
- ✏️ Edit Links - In-place editing with conflict resolution
- 🗑️ Delete - Confirmation dialogs with cascade handling
- 👁️ Publish Toggle - One-click status changes
- 📈 Click Metrics - Real-time click counts and trends
- 🌍 Geographic Data - Visitor country distribution
- 💻 Device Stats - OS and browser analytics
- 📅 Time Analysis - Visit patterns and peak hours
- 🎨 Material Design - Consistent Google Material Design
- 📱 Responsive Layout - Mobile-first responsive design
- ⚡ Fast Loading - Optimized bundle sizes and lazy loading
- 🔄 Real-time Updates - Live data without page refreshes
- 📋 Copy to Clipboard - One-click URL sharing
- 🔗 Dynamic Testing - Domain-agnostic test buttons
cd src
dotnet publish -c Release -o ../publishcd client
npm run build
# Files will be in client/build/ directory# Example Dockerfile for backend
FROM mcr.microsoft.com/dotnet/aspnet:9.0
WORKDIR /app
COPY publish/ .
EXPOSE 80
ENTRYPOINT ["dotnet", "ScissorLink.dll"]# Backend
ASPNETCORE_ENVIRONMENT=Production
ConnectionStrings__dbScissorLink=<production-connection-string>
# Frontend
REACT_APP_API_URL=https://your-api-domain.com/api- DTO Validation - Model validation with annotations
- URL Validation - Proper URL format checking
- Token Sanitization - Safe character validation
- SQL Injection Prevention - Parameterized queries with EF Core
- CORS Policy - Configurable cross-origin requests
- HTTPS Enforcement - SSL/TLS for production
- Error Masking - Safe error messages for users
- Rate Limiting Ready - Infrastructure for request throttling
- Memory Caching - 10-minute cache for frequently accessed links
- Connection Pooling - Optimized database connections
- Async Operations - Non-blocking I/O throughout
- EF Core Optimization - Selective loading and compiled queries
- Code Splitting - Lazy loading for optimal bundle sizes
- Component Memoization - React.memo for expensive renders
- Virtual Scrolling - Efficient large list rendering
- Service Worker Ready - PWA capabilities
# Start development environment
./start-dev.ps1 # or start-dev.bat
# Run backend tests
cd src
dotnet test
# Run frontend tests
cd client
npm test
# Build for production
cd src && dotnet publish -c Release
cd client && npm run build# Add new migration
dotnet ef migrations add NewFeatureName
# Update database
dotnet ef database update
# Generate SQL script
dotnet ef migrations script|
Q2 2025 🔐 Authentication System 📊 Advanced Analytics 🔄 Bulk Operations ⏰ Link Expiration |
Q3-Q4 2025 🏷️ Link Categories 🔗 Custom Domains 📱 QR Code Generation 🔒 Password Protection |
2026 & Beyond 📧 Email Integration 🔌 API Extensions 🌐 Multi-Language ☁️ Cloud Storage |
💡 Have ideas? Open an issue or start a discussion
We welcome contributions! Please follow these steps:
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Commit changes:
git commit -m 'Add amazing feature' - Push to branch:
git push origin feature/amazing-feature - Open a Pull Request
- Follow C# coding conventions and .NET best practices
- Use TypeScript for all frontend code
- Write unit tests for new features
- Update documentation for API changes
- Ensure responsive design for UI changes
This project is licensed under the MIT License - see the LICENSE file for details.
- MaxMind - GeoIP2 database for geolocation services
- Material-UI Team - Excellent React component library
- Microsoft - .NET platform and Entity Framework
- React Team - Amazing frontend framework
- Community Contributors - All the developers who contributed
- Documentation: Check this README and code comments
- Issues: Use GitHub Issues for bug reports and feature requests
- Discussions: Use GitHub Discussions for questions and ideas
🔗 ScissorLink - Cutting long URLs down to size since 2025
Where every click tells a story, and every link has a purpose
💬 Discussions • 🐛 Issues • 📧 Email • 📖 Documentation