Chronos for Jira is an app to track time spent on Jira issues. It is built with React Native and will soon be available for MacOS and Windows. The project is still in development, we got an open beta for MacOS though. You can join the beta by following the instructions here.

Getting started

To start the project you first have to install the dependencies:

npm install
npx pod-install ios
npx pod-install macos

After that you can start the development server. This will launch the Metro bundler which creates the JavaScript bundle for the app.

npm start

Once your Metro bundler is running, you can start the app by opening the Xcode project (Chronos.xcworkspace) in the macos directory and starting the app from within Xcode. The Xcode project contains two schemes: Chronos-macOS for development and Chronos-macOS-prod for the production build.

Safari extension

This app also contains a Safari extension which is built with the chronos-companion project using Plasmo. To update the extension, first make sure that you built the extension in the chronos-companion project. The chronos-companion repo should be in the same directory as this repo. Then run the following command to copy and adjust the extension files:

npm run copy-safari-extension

Common issues

React Native Debugger

It is recommended to use the React Native Debugger for development. You can download it here.

Debug starting issues

Sometimes the dev environment will not start after updating packages or other external dependencies. The reason for that is that can be outdated packages, cache issues or other problems. This commands will help you to solve the most common issues:

npm run clear-cache

Metro bundler not starting

Sometimes the Metro bundler will not start because of too many open files and the following error will be shown:

Error: EMFILE: too many open files, watch

This can be solved by installing watchman globally and clearing the watchman cache:

brew install watchman
watchman shutdown-server
watchman watch-del-all

Errors after upgrading react-native

Getting errors after upgrading react-native is a common issue. A good starting point is to check the react-native upgrade helper and follow the instructions there.