Welcome to the centralized issue tracker for the ViClip ecosystem. This repository is the single source of truth for reporting bugs, requesting features, and tracking issues across all ViClip platforms.
ViClip is a cross-platform clipboard synchronization app that allows users to seamlessly sync their clipboard content across all devices. The ecosystem includes:
- ViClip-Desktop – A cross-platform desktop app built with Electron
- ViClip-Mobile – A React Native mobile app built with Expo and TypeScript for iOS and Android
- ViClip-Website – The public-facing landing page and documentation site built with Next.js
- Search existing issues to avoid duplicates
- Identify the affected platform (desktop, mobile, or web)
- Gather relevant details: OS, app version, device info, sync behavior, etc.
- Collect logs, especially for desktop issues (see below)
- Click the “New Issue” button
- Select the appropriate issue template
- Fill out all required fields with as much detail as possible
- Attach logs (especially for desktop issues)
- Apply appropriate labels (
platform,type,priority) - Submit your issue — we’ll take it from there!
Including logs greatly speeds up our ability to troubleshoot problems.
- Windows:
%APPDATA%\ViClip\logs\ - macOS:
~/Library/Application Support/ViClip/logs/ - Linux:
~/.config/ViClip/logs/
Open the most recent .log files with any text editor.
- Error logs – Red entries related to crashes or failures
- Warning logs – Yellow entries that may be relevant
- Recent activity – Logs from the time the issue occurred
- Sync events – Logs showing clipboard sync attempts
- Crash reports – Full crash logs, if available
- No clipboard content is logged
- Logs may include timestamps and system/environment info
- Redact any personal or sensitive information before sharing
- Reproduce the issue, then immediately gather logs
- Include logs from before and after the issue occurred
- Compress large logs before uploading
platform: desktop– Electron desktop app issuesplatform: mobile– Mobile app (iOS/Android) issuesplatform: website– Landing page issuesplatform: all– Cross-platform sync or ecosystem-wide issues
type: bug– Something isn’t working as expectedtype: feature– Request for new functionalitytype: enhancement– Improvements to existing featurestype: performance– Speed, efficiency, or battery issuestype: documentation– Docs or repo-related updates
priority: critical– Breaks core functionality like syncpriority: high– Major impact but still somewhat usablepriority: medium– Moderate issues with workaroundspriority: low– Minor bugs or nice-to-haves
To ensure clarity and consistency, we provide templates for each platform:
- Clipboard sync problems
- Electron crashes or performance issues
- Desktop UI/UX bugs
- Installation or update issues
→ Logs are required
- Clipboard sync failures on iOS/Android
- Platform-specific bugs (Expo/React Native)
- Battery usage or performance problems
- Background sync issues
- Display or layout problems
- Broken or incorrect functionality
- Browser compatibility issues
- Outdated or missing information
- New – Issue submitted, pending triage
- Triaged – Labels added, issue reviewed
- In Progress – Actively being worked on
- Testing – Fix/feature under testing
- Resolved – Fix verified and included in a release
- Closed – Resolved or deemed invalid
We welcome community involvement!
- Report sync issues with clear steps and logs
- Suggest features that enhance your workflow
- Test beta versions and provide feedback
- Help answer other users’ questions
ViClip is currently closed-source. However, we may open-source it based on community interest. Stay tuned!
- Browse open issues and join discussions
- Read our docs and troubleshooting guides
- Still stuck? Email us: [email protected]
- Framework: Electron + Vite
- Language: TypeScript
- Build Tool: Electron-Builder
- OS Support: Windows, macOS, Linux
- Framework: React Native + Expo
- Language: TypeScript
- Platforms: iOS, Android
- Framework: Next.js
- Purpose: Product landing page and docs
This issue tracker helps us:
- ✅ Centralize feedback across all platforms
- ✅ Reduce duplicate bug reports
- ✅ Track and improve cross-device sync
- ✅ Streamline support and debugging
- ✅ Provide a better developer & user experience
This repository is for issue tracking only. Refer to platform-specific repos for code and license details.
Thank you for helping make ViClip better! 🚀
💡 Pro Tip: Including desktop logs with your report helps us fix your issue much faster!