{"id":30310809,"url":"https://github.com/fahadnasir13/financial-data-parser-application","last_synced_at":"2026-06-17T23:31:23.657Z","repository":{"id":307969787,"uuid":"1031226415","full_name":"fahadnasir13/Financial-Data-Parser-Application","owner":"fahadnasir13","description":"“Financial Data Parser – Advanced Next.js \u0026 TypeScript app for parsing and visualizing complex financial datasets with confidence scoring and exportability.”","archived":false,"fork":false,"pushed_at":"2025-08-03T10:05:51.000Z","size":179,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-03T11:31:34.481Z","etag":null,"topics":["data-parsing","data-visualization","financial-parser","framer-motion","framer-motion-3d","nextjsdata-parsing","react-testing-library","shadcn-ui"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fahadnasir13.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-03T09:41:31.000Z","updated_at":"2025-08-03T10:05:54.000Z","dependencies_parsed_at":"2025-08-03T11:47:57.607Z","dependency_job_id":null,"html_url":"https://github.com/fahadnasir13/Financial-Data-Parser-Application","commit_stats":null,"previous_names":["fahadnasir13/financial-data-parser-application"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/fahadnasir13/Financial-Data-Parser-Application","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fahadnasir13%2FFinancial-Data-Parser-Application","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fahadnasir13%2FFinancial-Data-Parser-Application/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fahadnasir13%2FFinancial-Data-Parser-Application/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fahadnasir13%2FFinancial-Data-Parser-Application/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fahadnasir13","download_url":"https://codeload.github.com/fahadnasir13/Financial-Data-Parser-Application/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fahadnasir13%2FFinancial-Data-Parser-Application/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270863032,"owners_count":24658712,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-17T02:00:09.016Z","response_time":129,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data-parsing","data-visualization","financial-parser","framer-motion","framer-motion-3d","nextjsdata-parsing","react-testing-library","shadcn-ui"],"created_at":"2025-08-17T15:01:52.919Z","updated_at":"2026-06-17T23:31:23.628Z","avatar_url":"https://github.com/fahadnasir13.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Financial Data Parser\r\n\r\nAn enterprise-grade financial data parsing application built with Next.js, TypeScript, and modern web technologies. This application provides intelligent parsing of financial data with confidence scoring, comprehensive filtering, and visual analytics.\r\n\r\n## 🚀 Features\r\n\r\n### Core Functionality\r\n- **Smart Financial Parsing**: Supports US, European, Indian, and abbreviated number formats\r\n- **Type Detection**: Automatically detects currency, percentage, number, date, and text data types\r\n- **Confidence Scoring**: AI-powered confidence assessment for parsed values\r\n- **Multi-format Import**: CSV, JSON, and manual data entry support\r\n- **Real-time Processing**: Instant parsing and validation with progress indicators\r\n\r\n### Data Management\r\n- **Advanced Filtering**: Filter by type, confidence score, and search queries\r\n- **Range Search**: Date range and numerical range filtering capabilities\r\n- **Data Export**: Export processed data in CSV and JSON formats\r\n- **Persistent Storage**: Browser-based storage with automatic save/restore\r\n\r\n### Visualization \u0026 Analytics\r\n- **Interactive Charts**: Pie charts, bar charts, and distribution analysis\r\n- **Data Quality Metrics**: Confidence distribution and format analysis\r\n- **Real-time Insights**: Live statistics and data quality assessment\r\n- **Responsive Design**: Optimized for desktop and mobile viewing\r\n\r\n### Technical Excellence\r\n- **Type Safety**: Full TypeScript implementation with strict type checking\r\n- **Error Handling**: Comprehensive error boundaries and validation\r\n- **Testing Suite**: Unit tests, integration tests, and API testing\r\n- **Performance**: Optimized rendering with React 18 and Next.js 13\r\n\r\n## 🛠 Technology Stack\r\n\r\n### Frontend\r\n- **Next.js 13**: React framework with App Router\r\n- **TypeScript**: Type-safe development\r\n- **Tailwind CSS**: Utility-first styling\r\n- **Shadcn/ui**: Modern component library\r\n- **Framer Motion**: Smooth animations and transitions\r\n- **Recharts**: Data visualization library\r\n\r\n### Backend\r\n- **Next.js API Routes**: Serverless API endpoints\r\n- **Custom Parsing Engine**: Advanced financial data processing\r\n- **In-memory Storage**: Fast data operations with persistence\r\n\r\n### Testing \u0026 Quality\r\n- **Jest**: Unit and integration testing\r\n- **React Testing Library**: Component testing\r\n- **TypeScript**: Static type checking\r\n- **ESLint**: Code quality and consistency\r\n\r\n## 📦 Installation\r\n\r\n1. **Clone the repository**\r\n   ```bash\r\n   git clone https://github.com/fahadnasir13/financial-data-parser.git\r\n   cd financial-data-parser\r\n   ```\r\n\r\n2. **Install dependencies**\r\n   ```bash\r\n   npm install\r\n   ```\r\n\r\n3. **Run the development server**\r\n   ```bash\r\n   npm run dev\r\n   ```\r\n\r\n4. **Open your browser**\r\n   Navigate to [http://localhost:3000](http://localhost:3000)\r\n\r\n## 🧪 Testing\r\n\r\nRun the comprehensive test suite:\r\n\r\n```bash\r\n# Run all tests\r\nnpm test\r\n\r\n# Run tests in watch mode\r\nnpm run test:watch\r\n\r\n# Run tests with coverage\r\nnpm test -- --coverage\r\n```\r\n\r\n### Test Coverage\r\n- **Unit Tests**: Individual component and function testing\r\n- **Integration Tests**: Full application workflow testing\r\n- **API Tests**: Backend parsing engine validation\r\n- **Context Tests**: State management verification\r\n\r\n## 🏗 Project Structure\r\n\r\n```\r\nfinancial-data-parser/\r\n├── app/                    # Next.js App Router\r\n│   ├── api/               # API routes\r\n│   ├── globals.css        # Global styles\r\n│   ├── layout.tsx         # Root layout\r\n│   └── page.tsx          # Home page\r\n├── components/            # React components\r\n│   ├── ui/               # Shadcn/ui components\r\n│   ├── DataImport.tsx    # Data import interface\r\n│   ├── DataTable.tsx     # Data display table\r\n│   ├── DataVisualization.tsx # Charts and analytics\r\n│   └── ParsingEngine.tsx # Parsing status display\r\n├── contexts/             # React contexts\r\n│   └── FinancialDataContext.tsx # Global state management\r\n├── hooks/                # Custom React hooks\r\n│   └── use-toast.ts      # Toast notifications\r\n├── lib/                  # Utility functions\r\n│   └── utils.ts          # Helper utilities\r\n├── __tests__/            # Test files\r\n│   ├── components/       # Component tests\r\n│   ├── contexts/         # Context tests\r\n│   ├── api/             # API tests\r\n│   └── integration/     # Integration tests\r\n└── types/               # TypeScript type definitions\r\n```\r\n\r\n## 🔧 Configuration\r\n\r\n### Environment Variables\r\nCreate a `.env.local` file for local development:\r\n\r\n```env\r\n# Add any environment-specific variables here\r\nNEXT_PUBLIC_APP_NAME=Financial Data Parser\r\n```\r\n\r\n### Tailwind Configuration\r\nThe application uses a custom Tailwind configuration with:\r\n- Custom color palette for financial data visualization\r\n- Extended spacing and typography scales\r\n- Dark mode support\r\n- Animation utilities\r\n\r\n## 📊 Parsing Engine\r\n\r\n### Supported Formats\r\n\r\n#### Currency Formats\r\n- **US Format**: `$1,234.56`, `$1,000,000.00`\r\n- **European Format**: `€1.234,56`, `€1.000.000,00`\r\n- **Indian Format**: `₹1,23,456.78`, `₹10,00,000.00`\r\n- **Negative Values**: `-$500.00`, `($500.00)`\r\n\r\n#### Number Formats\r\n- **Abbreviated**: `2.5K`, `1.2M`, `3.5B`\r\n- **Percentages**: `15.5%`, `-2.3%`, `100%`\r\n- **Scientific**: `1.23e+6`, `4.56E-3`\r\n- **Fractions**: `1/2`, `3/4`, `22/7`\r\n\r\n#### Date Formats\r\n- **US Format**: `03/15/2024`, `12/31/2023`\r\n- **ISO Format**: `2024-03-15`, `2023-12-31`\r\n- **Named Months**: `Mar 15, 2024`, `December 31, 2023`\r\n\r\n### Confidence Scoring\r\n- **90-100%**: High confidence, well-formatted data\r\n- **70-89%**: Medium confidence, minor formatting issues\r\n- **50-69%**: Low confidence, ambiguous formatting\r\n- **Below 50%**: Very low confidence, likely text data\r\n\r\n## 🎨 Design System\r\n\r\n### Color Palette\r\n- **Primary**: Blue (#0ea5e9) - Trust and reliability\r\n- **Secondary**: Emerald (#10b981) - Success and growth\r\n- **Accent**: Orange (#f97316) - Energy and attention\r\n- **Supporting**: Purple (#8b5cf6), Red (#ef4444), Gray (#6b7280)\r\n\r\n### Typography\r\n- **Headings**: Inter font family, multiple weights\r\n- **Body**: Optimized line height (1.5) for readability\r\n- **Code**: Monospace font for data display\r\n\r\n### Components\r\n- **Cards**: Elevated surfaces with subtle shadows\r\n- **Buttons**: Multiple variants with hover states\r\n- **Forms**: Accessible inputs with validation\r\n- **Tables**: Responsive data display with sorting\r\n- **Charts**: Interactive visualizations with tooltips\r\n\r\n## 🚀 Deployment\r\n\r\n### Build for Production\r\n```bash\r\nnpm run build\r\n```\r\n\r\n### Static Export\r\nThe application is configured for static export:\r\n```bash\r\nnpm run build \u0026\u0026 npm run export\r\n```\r\n\r\n### Deployment Platforms\r\n- **Vercel**: Optimized for Next.js applications\r\n- **Netlify**: Static site hosting with form handling\r\n- **GitHub Pages**: Free hosting for open source projects\r\n\r\n## 🤝 Contributing\r\n\r\n1. **Fork the repository**\r\n2. **Create a feature branch**: `git checkout -b feature/amazing-feature`\r\n3. **Commit your changes**: `git commit -m 'Add amazing feature'`\r\n4. **Push to the branch**: `git push origin feature/amazing-feature`\r\n5. **Open a Pull Request**\r\n\r\n### Development Guidelines\r\n- Follow TypeScript best practices\r\n- Write tests for new features\r\n- Use conventional commit messages\r\n- Ensure accessibility compliance\r\n- Maintain responsive design\r\n\r\n## 📝 License\r\n\r\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\r\n\r\n## 🙏 Acknowledgments\r\n\r\n- **Shadcn/ui**: Beautiful and accessible component library\r\n- **Recharts**: Powerful charting library for React\r\n- **Framer Motion**: Smooth animations and gestures\r\n- **Tailwind CSS**: Utility-first CSS framework\r\n- **Next.js**: The React framework for production\r\n\r\n## 📞 Support\r\n\r\nFor support, email fahadnasir1311@gmail.com or join our Slack channel.\r\n\r\n## 🔄 Changelog\r\n\r\n### Version 1.0.0\r\n- Initial release with core parsing functionality\r\n- Support for multiple financial formats\r\n- Interactive data visualization\r\n- Comprehensive test suite\r\n- Production-ready deployment configuration\r\n\r\n\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffahadnasir13%2Ffinancial-data-parser-application","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffahadnasir13%2Ffinancial-data-parser-application","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffahadnasir13%2Ffinancial-data-parser-application/lists"}