{"id":29989804,"url":"https://github.com/policyengine/vatlab","last_synced_at":"2025-08-04T23:27:04.508Z","repository":{"id":307577151,"uuid":"1029837627","full_name":"PolicyEngine/vatlab","owner":"PolicyEngine","description":null,"archived":false,"fork":false,"pushed_at":"2025-08-01T00:33:26.000Z","size":678,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-01T01:38:09.396Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/PolicyEngine.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-07-31T16:47:31.000Z","updated_at":"2025-08-01T00:33:51.000Z","dependencies_parsed_at":"2025-08-01T01:49:35.765Z","dependency_job_id":null,"html_url":"https://github.com/PolicyEngine/vatlab","commit_stats":null,"previous_names":["policyengine/vatlab"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/PolicyEngine/vatlab","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PolicyEngine%2Fvatlab","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PolicyEngine%2Fvatlab/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PolicyEngine%2Fvatlab/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PolicyEngine%2Fvatlab/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PolicyEngine","download_url":"https://codeload.github.com/PolicyEngine/vatlab/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PolicyEngine%2Fvatlab/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268802449,"owners_count":24309657,"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-04T02:00:09.867Z","response_time":79,"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":[],"created_at":"2025-08-04T23:26:58.805Z","updated_at":"2025-08-04T23:27:04.498Z","avatar_url":"https://github.com/PolicyEngine.png","language":"JavaScript","readme":"# VATLab - PolicyEngine VAT Microsimulation Dashboard\n\nA web-based microsimulation tool for analyzing UK Value Added Tax (VAT) policy reforms and their economic impacts.\n\n## Overview\n\nVATLab allows users to simulate various VAT policy scenarios including:\n- Changes to registration thresholds\n- Graduated threshold systems\n- Split rates for labor-intensive industries\n- Behavioral responses to policy changes\n\n## Features\n\n- **Interactive Policy Configuration**: Adjust VAT thresholds, rates, and industry classifications\n- **Real-time Impact Analysis**: See revenue projections and firm-level impacts\n- **Data Visualization**: Charts showing revenue over time, winner/loser distributions, and sectoral impacts\n- **Calibration to Official Statistics**: Model validated against ONS and HMRC data\n- **Synthetic Firm Generation**: Creates representative microdata matching UK business distributions\n\n## Quick Start\n\n### Prerequisites\n- Node.js 22+ \n- npm\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/PolicyEngine/vatlab.git\ncd vatlab\n\n# Install dependencies\ncd vatlab\nnpm install\n\n# Start development server\nnpm run dev\n```\n\nVisit http://localhost:3000/vat-analysis to use the dashboard.\n\n## Project Structure\n\n```\nvatlab/\n├── vatlab/                # Next.js web application\n│   ├── components/         # React components\n│   ├── pages/             # Application pages\n│   └── styles/            # CSS styles\n├── data/                  # Data sources and generators\n│   ├── ons-business-statistics/  # ONS business data\n│   └── synthetic_firm_generator.py  # Synthetic data generation\n└── README.md\n```\n\n## Data Sources\n\nThe model uses official UK government statistics:\n- **ONS Business Statistics**: Enterprise counts by industry, size, and location\n- **HMRC VAT Statistics**: Registration data and revenue figures\n- **Living Costs and Food Survey**: Household spending patterns\n\nSee `data/README.md` for detailed information about data sources and synthetic firm generation methodology.\n\n## Usage Guide\n\n1. **Choose Baseline**: Configure the baseline VAT policy (current UK policy or custom)\n2. **Set Reform Parameters**: Define your reform scenario in the Reform tab\n3. **Run Analysis**: Click \"Analyse VAT Policy\" to generate results\n4. **Review Impacts**: Explore revenue changes, firm distributions, and sectoral effects\n\n## Key Policy Parameters\n\n- **Registration Threshold**: Annual turnover above which firms must register for VAT\n- **Graduated Threshold**: Optional upper threshold for smooth transition\n- **Labor-Intensive Industries**: Sectors eligible for reduced rates\n- **VAT Rates**: Separate rates for labor-intensive and standard businesses\n- **Elasticity**: Behavioral response parameter\n\n## Development\n\n### Running Tests\n```bash\nnpm test\n```\n\n### Building for Production\n```bash\nnpm run build\nnpm start\n```\n\n### Code Style\n- React: Functional components with hooks\n- Formatting: Prettier + ESLint\n- Run `npm run lint` before committing\n\n## Deployment\n\nThe application can be deployed to any Node.js hosting platform. For GitHub Pages deployment, see `.github/workflows/deploy.yml`.\n\n## License\n\nOpen source under the MIT License.\n\n## Contributing\n\nContributions are welcome! Please:\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Run tests and linting\n5. Submit a pull request\n\n## Contact\n\nFor questions or support, please open an issue on GitHub.\n\n## Acknowledgments\n\nThis tool uses synthetic data for demonstration purposes. The methodology is based on official UK statistics from ONS and HMRC.","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpolicyengine%2Fvatlab","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpolicyengine%2Fvatlab","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpolicyengine%2Fvatlab/lists"}