The official Wikipedia KaiOS app. KaiOS is a web-based mobile operating system that enables a new category of smart feature phones, a successor of the discontinued Firefox OS.

The Wikipedia KaiOS app is built with Preact, we use Cypress for testing, and Translatewiki for translations. Tasks and issues are tracked on Phabricator.

• Make sure git is installed: brew install git
• Make sure node is installed: node -v or brew install node
• Make sure npm is installed: npm -v or brew install npm
• Make sure the Firefox browser is installed

1. Create a directory for code: mkdir ~/code && cd ~/code
2. Download the app source repository: git clone https://github.com/wikimedia/wikipedia-kaios.git

1. Make sure you are in the source directory: cd wikipedia-kaios
2. Downloading the latest code: git pull
3. Install app dependencies: npm install
4. Build the app: npm run dev

Now the app is running on your computer at http://127.0.0.1:8080 in Firefox. You can open the Firefox Developer Tools and use the Responsive Design Mode to interact with the app in a more appropiate setting.

1. Create a directory for code: mkdir ~/code && cd ~/code
2. Download the app source repository: git clone https://github.com/wikimedia/wikipedia-kaios.git
3. Go to the app source: cd wikipedia-kaios

1. Install app dependencies: npm install

1. Connect your device to your computer using a USB cable
2. Enable debug mode on the device by typing: *#*#33284#*#*
3. Check that adb is running and sees your device: adb devices

1. Deploy to device, this will take a few minutes: npm run deploy

The Wikipedia app should be running on your device now.

npm install && npm run build && npm run dev

npm test

npm run cypress:open

1. Make sure you are in the source directory: cd ~/code/wikipedia-kaios
2. Pull the latest changes: git pull
3. Install latest dependencies: npm install
4. Rebuild the app: npm run build
5. Redeploy the app: npm run deploy