Welcome to Fairfood's revolutionary traceability solution! The Fairfood Dashboard, built with Angular 15, provides an intuitive interface for agri-food businesses to trace their products, manage transactions, and monitor stock levels.
Follow these steps to set up the project on your local machine:
-
NodeJS and Angular:
- Install NodeJS (version 14.15 or higher).
- Install the Angular version (15.2.3).
- Application's current Angular version is 15 to ensure maximum compatibility
-
Clone the Repository:
git clone [email protected]:fairfood/trace-v2/frontend/fairfood-trace-dashboard-v3.git
-
Navigate to the Cloned Directory:
cd fairfood-trace-dashboard-v3
-
Install Dependencies:
npm install
To run the application on your local machine:
-
Execute Angular CLI:
ng serve
-
Connect to API Server:
- By default, the application connects to the dev API server.
- Change the API server in
src/environment.ts
if needed.
The Fairfood Dashboard supports four environments:
- Dev: Used for development and QA testing.
- Stage: Application verification server.
- Prod: Live production application.
- Demo: For demonstration purposes (for stakeholders/business groups).
To build the application for production:
ng build --prod --c=${production/staging/dev/demo}
Execute unit tests via Karma:
ng test
- ESLint
- Prettier
- file-saver
- ngx-image-cropper
- ngx-translate
- ng2-charts
- js-marker-clusterer
- html2canvas
- html-to-image
- dom-to-image
- chart.js
- ngx-qrcode
- totp-generator
This project is open source and welcomes contributions! Feel free to explore, modify, and enhance the Fairfood Dashboard. If you have any questions or feedback, please reach out to our community.