Show HN: InstaTrack: open-source, privacy-first Instagram analytics (local)

A privacy-focused Instagram analytics tool built with Next.js that helps you track your followers and following over time. All data processing happens locally in your browser - no data is ever sent to external servers.

• 🔒 Privacy First: All data processing happens locally in your browser
• 📈 Trend Analysis: Track follower/following growth over time with interactive charts
• 🔍 Smart Analysis: Insights to identify non-reciprocal relationships
• 📊 Visual Dashboard: Clean, responsive interface with real-time stats
• 💾 Data Management: Backup and restore your data anytime
• 📱 Mobile Friendly: Fully responsive design for all devices

Try the live version at https://instatrack.njoylab.com

• Node.js 18+
• npm or yarn

1. Clone the repository

   git clone <repository-url> cd instatrack

2. Install dependencies

3. Start development server

4. Open your browser Navigate to http://localhost:9002

1. Go to Instagram's data download page
2. Select "Request a download"
3. Choose "Select types of information"
4. Select "Followers and following"
5. Set format to JSON and date range to "All time"
6. Download and extract the files

1. Click "New Snapshot" in the app
2. Upload your followers_1.json and following.json files
3. Your snapshot will be created and stored locally

• Overview: See your current stats and growth trends
• Analysis: Discover who doesn't follow you back and vice versa
• Changes: Track what changed between snapshots

• Framework: Next.js 15 with App Router
• Language: TypeScript
• Styling: Tailwind CSS + shadcn/ui components
• Charts: Recharts
• Icons: Lucide React
• Testing: Jest + React Testing Library

• dashboard-client.tsx - Main dashboard with tabs
• import-dialog.tsx - File import functionality
• overview-tab.tsx - Stats and charts display
• analysis-tab.tsx - Analysis and insights
• changes-tab.tsx - Change tracking between snapshots
• use-snapshots.ts - Data management hook

The project includes comprehensive tests for:

• Utility functions - Core logic and helpers
• Custom hooks - Data management and mobile detection
• Components - UI components and user interactions
• Types - TypeScript type definitions

Run tests with:

The app runs client-side and doesn't require environment variables for basic functionality.

• Styling: Modify tailwind.config.ts and component styles
• Data Structure: Extend types in src/lib/types.ts

• Local Processing: All data stays in your browser's localStorage
• No External Servers: No data is transmitted to external services
• Export/Import: Full control over your data with backup/restore
• Open Source: Transparent codebase you can audit

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

• Follow the existing code style (ESLint + Prettier)
• Write tests for new features
• Update documentation as needed
• Ensure TypeScript compliance

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

If you encounter any issues or have questions:

1. Check the FAQ page in the app
2. Search existing GitHub issues
3. Create a new issue with detailed information

• Next.js - React framework
• shadcn/ui - UI components
• Tailwind CSS - Styling
• Recharts - Data visualization

Made with ❤️ for Instagram users who want to understand their social connections better.