Skip to content

hoodiehq/hoodie-app-tracker

Repository files navigation

hoodie-app-tracker

Default Hoodie app

Build Status Dependency Status devDependency Status

Tracker is a simple Hoodie app, meant to be a starting point to play and build with Hoodie.

Find the repository on GitHub.

Offline

In most situations this app will run when your device is offline. The app does this by using the Service Worker standard. All mainstream web browsers support Service Worker. Where Service Worker is not supported, the app won't work offline. Please see the start-service-worker.js and sw.js for details of how this is configured.

Install app

The app behaves like a native app on some devices by using the manifest.json file. This functionality is currently fully supported by the Chrome and Opera browsers with some features supported by other browsers. The manifest provides information for the web app to behave like a native app. For instance, on mobile devices by allowing users to install an icon on the homepage and provides a splash/loading page when opening.

Requirements

Tracker needs node >=4. To see which version you have installed, run

node -v

Setup

git clone https://github.com/hoodiehq/hoodie-app-tracker.git
cd hoodie-app-tracker
npm install --production

Start server with

npm start

Optional: Setup email for password reset

If you want to use the password reset feature, you must configure an email account to send out notification, like a Google Mail account. Edit the .hoodierc file, the options are passed to nodemailer.createTransport()

cp .hoodierc-example .hoodierc

Deployment

You can find a detailed instruction here.

Contribute

hoodie-app-tracker is work in progress. The goal is to have a simple application with very clear and easy to understand HTML / CSS / JS code which ideally uses no 3rd party code at all, besides the Hoodie client.

If you want to contribute to the frontend assets, you can simply open the project folder and edit the files in the public/ folder.

Tests

Install devDependencies by running npm install without --production

npm install

Then run tests with

npm test

The tests are written using the Cypress library. Cypress allows interactively viewing the tests within a browser. This is really useful as it allows you to see the tests running. The tests can be stopped, rewound and easily debugged. To run the tests interactively

npm run cypress:open

Need help or want to help?

It’s best to join our chat.

License

Apache 2.0