Development

Navigating the source-code

Kiwi is based on Chromium, to find code, use https://source.chromium.org/chromium/chromium/src

The most commonly asked files are:

Android:

• Main menu is in: chrome/android/java/src/org/chromium/chrome/browser/app/appmenu
• Settings screen is in: chrome/android/java/src/org/chromium/chrome/browser/settings and chrome/android/java/res/xml

HTML:

• kiwi://extensions is in: chrome/browser/resources/extensions
• kiwi://chrome-search (new tab page) is in: chrome/browser/resources/new_tab_page_instant

Translations:

• To add a new translation string in English: chrome/android/java/res/values/strings.xml
• To translate strings in other languages, go to https://crowdin.com/project/kiwibrowser and once you have updated the translations, run workflow "Kiwi: Download translations from Crowdin" to download them back to the repository

Git

Resolving issues

If you need to add or remove commits where you have done mistake, git rebase -i 3eb71bb7cae580107938f6394513462e67033f8a After rebasing, you need to fix the date and time of the commits by running git rebase 3eb71bb7cae580107938f6394513462e67033f8a --committer-date-is-author-date

3eb71bb7cae580107938f6394513462e67033f8a is the root commit from which both Kiwi and Chromium branch are born from.

Updating your local repository

In order to keep the history clean, we are using rebase, and not merge, to fetch the latest modifications you can use:

git fetch

git rebase origin/kiwi --committer-date-is-author-date

In a normal situation, this is going to show First, rewinding head to replay your work on top of it...

Accepting pull requests

When you accept a pull request:

• If the source repository has very clean commits description, and you want the commits to appear as-they-are in the source repository, use Rebase and merge.

• If the source repository has multiple commits for the fix or the commit names are not very explicit or messy, use Squash and merge.