MTD4L is a full-stack solution for UK landlords to manage rental properties, record income and expenses, and submit tax updates directly to HMRC under the Making Tax Digital (MTD) initiative.
- Frontend: Angular SPA for property management, transaction recording, and HMRC submissions.
- Backend: ASP.NET Core Web API with SQL Server, supporting authentication, property, transaction, obligation, and submission management.
- HMRC Integration: OAuth2 authentication and submission endpoints for quarterly updates, EOPS, and final declarations (sandbox/test NINO).
- Testing: Unit tests (Karma/Jasmine) and e2e test scaffolding.
- Development: Local HTTPS proxy for SPA/backend integration.
- Landlords can register, log in, and manage their rental portfolio.
- Users can record income/expense transactions and categorize them.
- Obligations are synced from HMRC and tracked in-app.
- Quarterly, EOPS, and final submissions can be sent to HMRC via secure API.
- All data is stored securely and can be managed via the dashboard.
This project is under active development. For build/run instructions, see below.
-
Clone the Repository
git clone https://github.com/your-org/mtd4l.git
-
Open Solution
- Launch Visual Studio 2019.
- Open the
MTD4L.sln
solution file.
-
Restore Dependencies
- Visual Studio will automatically restore NuGet packages on solution load.
- For the Angular frontend, open a terminal in
/ClientApp
and run:npm install
-
Configure Environment
- Update your SQL Server connection string and HMRC sandbox credentials using user secrets or environment variables.
Do not modify sensitive settings directly inappsettings.*.json
files!.
- Update your SQL Server connection string and HMRC sandbox credentials using user secrets or environment variables.
-
Run the Application
- Set the Web API project as the startup project.
- Press
F5
to build and run both backend and frontend (the SPA will proxy through the backend).