A modern web application for analyzing faction member performance and respect contributions in Torn City. Track, compare, and export detailed statistics about your faction's attack data with an intuitive interface and powerful filtering options.
- Member Performance Tracking: Detailed statistics for each faction member including total respect, attack counts, success rates, and specialized metrics
- Interactive Charts: Visual representations of faction performance with dark mode support
- Respect Timeline: Track cumulative respect gains over time
- Top Performers: Identify your faction's most valuable contributors
- Time Range Filters: Analyze data from specific time periods (1 hour to all-time)
- Member Comparison: Multi-select member comparison with search functionality
- Attack Type Filtering: Filter by war, chain, bonus, regular, retaliation, and overseas attacks
- Result Filtering: Focus on specific attack outcomes (attacked, mugged, hospitalized, etc.)
- Bonus Hit Detection: Identify and analyze chain bonus hits at 10, 20, 40, 80+ respect
- Session Caching: Intelligent caching system for improved performance
- Multiple Export Formats: Export data as CSV or JSON
- Real-time Sync: Fetch the latest faction data with progress tracking
- Pagination Support: Efficient handling of large datasets
- Dark Mode: Full dark theme with system preference detection
- Responsive Design: Optimized for desktop and mobile devices
- Accessibility: Screen reader support and keyboard navigation
- Loading States: Smooth loading indicators and progress bars
- Node.js 18+ and pnpm
- A valid Torn API key
-
Clone the repository
git clone https://github.com/Edgeworthless/tornrespect.git cd tornrespect -
Install dependencies
pnpm install
-
Start the development server
pnpm dev
-
Open your browser Navigate to
http://localhost:5173
-
Get your Torn API Key
- Go to Torn Preferences > API
- Generate a new API key with appropriate permissions
-
Configure the application
- Click the settings icon (⚙️) in the header
- Enter your API key
- Click "Save"
-
Sync faction data
- Click the "Sync" button to fetch your faction's attack data
- The app will automatically cache data for improved performance
- War Attacks: Attacks made during faction wars
- Chain Attacks: Attacks made during faction chains (chain > 9)
- Bonus Hits: Special chain attacks at respect milestones (10, 20, 40, 80, 160, 320...)
- Regular Attacks: Standard faction attacks
- Retaliation: Revenge attacks
- Overseas: Attacks made while traveling
- Total Respect: Sum of all respect gained from successful attacks
- Success Rate: Percentage of successful attacks vs total attempts
- Fair Fight Efficiency: Average fair fight bonus multiplier
- Best Single Hit: Highest respect gained from a single attack
- Days in Faction: Member tenure tracking
- Frontend: React 18 with TypeScript
- Styling: Tailwind CSS with dark mode support
- Charts: Recharts for data visualization
- Icons: Heroicons
- API: Torn API v2 with cursor-based pagination
- Build Tool: Vite
- Client-side only: No backend required - runs entirely in the browser
- Context API: Centralized state management
- Session Storage: Persistent caching between sessions
- Rate Limiting: Respects Torn API rate limits (600ms delays)
- Error Handling: Comprehensive error states and user feedback
- Batch Processing: Processes attacks in batches of 500
- Smart Caching: Avoids redundant API calls
- Lazy Loading: Efficient data loading strategies
- Debounced Filtering: Smooth filter interactions
- Local Storage Only: All data is stored locally in your browser
- No External Servers: Your API key never leaves your device
- Secure API Calls: Direct communication with Torn's official API
- No Data Collection: We don't track or store any personal information
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- TypeScript with strict mode
- ESLint and Prettier configuration
- Tailwind CSS for styling
- Conventional commit messages
This project is licensed under the MIT License - see the LICENSE file for details.
- Torn City: For providing the comprehensive API that makes this project possible
- The Torn Community: For feedback and feature suggestions
- Open Source Libraries: All the amazing tools that power this application
If you encounter any issues or have questions:
- Check the Issues: Look through existing GitHub Issues
- Create a New Issue: If your problem isn't covered, create a new issue with details
- Torn Profile: Contact Manuel [3747263] in-game
Made with ❤️ by Manuel [3747263]