The Terraso Library is a Progressive Web App that allows the user to view documents (images, PDFs, text files, etc.) and store them for offline reading. This was created as part of the 1000 Landscapes Project primarily to research the functionality and limitations of Progressive Web Apps. This relies on Amazon Web Services: AppSync, DynamoDB, and Amazon S3.
The homepage contains an overview viewer:
You can change languages using a dropdown menu. English, French and Spanish are available.
The Documents page contains a list of Documents (fetched from a GraphQL API)
You can click (or tap, if on mobile) on buttons to open a Document.
Clicking (or tapping) the heart button next to each Document will favorite that document, adding it to the Cache and making that document available offline.
The Terraso Library is a Progressive Web App (PWA) and can be installed to the homescreen of a mobile device. How to install a Progressive Web App onto the homescreen of a mobile device.
Before using the Terraso Library, install git, node and npm. You will also need an Amazon Web Services (AWS) account to configure it like we have. It should work without AWS, but we don't have instructions for that.
git clone https://github.com/techmatters/terraso-library-prototype
cd terraso-library-prototype
npm install
npm run start
cp .sample.env .env
- Summary of the Goal/Purpose of the Terraso Library outlines some of the design choices and and difficulties encountered during the project as well as features that could be implemented in the future.