[Monorepo] Merge to master

[Tug]

*** To View Gutenberg-Mobile git history from before this merge, use the following fork: https://github.com/wordpress-mobile/gutenberg-rnmobile-monorepo-commit-history/

Description

This is the final PR that aims at merging the Monorepo effort in master.

What is Monorepo?

Monorepo is the name we gave to the project of merging gutenberg-mobile (the react-native version of gutenberg) and gutenberg together. Thus this PR contains all the commits from gutenberg-mobile plus some extra commits to make it work (see How has this been tested?).

With this PR comes a new flavour of the block editor: a native version that can run on both iOS and Android!

You can try the demo app from this branch by running npm run native start:reset followed by npm run android (or npm run ios) in a new terminal. You will need either the Android SDK or XCode installed on your machine (a docker based script should come later).

Why Monorepo?

Monorepo is a first step in making Gutenberg a cross-platform project. We’re not there yet as the project is still very much web in its direction. However, we have great hopes for developers to be able to create an amazing editing experience for both the web platform and native apps at the same time.

Many times we’ve seen changes to web code break the native build. This is because we were not able to fully convert gutenberg to native from day one so we had to make compromises and often duplicate features or components to have it working.

To address this issue we decided to simplify the gutenberg contributor’s journey in developing for mobile by providing all the necessary tools to run and test their code from within gutenberg. Moreover we would be adding back the mobile CI tests on every gutenberg PRs in order to spot regressions and help developers solve them.

What is going to change for web devs? #

This final merge PR has all the changes. Most of it are mobile build additions but it also has some minor changes web devs might want to be aware of:

• We added 4 new CI jobs (as github actions) which will run on each PR for e2e testing of the mobile demo app.
• We have added new dev dependencies such as appium, jest and metro (details here). Those were needed to have all our native scripts working.
• Updates to tsconfig.base.json: we’re explicitly defining the types the web will load (see this discussion). We’re also excluding any files from the react-native packages.
• Update to the check licenses script to exclude the react-native cli dependency.
• Three new packages: react-native-aztec, react-native-bridge and react-native-editor
• A new npm command npm run native to run native scripts in packages/react-native-editor/package.json

For a complete history of Monorepo please see the master PR.

What is going to change for mobile devs?

A bunch of new npm commands are now available:

New commands
Start the Metro server	npm run native start
Reset cache and start the Metro server	npm run native start:reset
Start the demo version for iOS	npm run native ios
Start the demo version for Android	npm run native android
Run native tests	npm run native test
Run e2e tests locally for iOS	npm run native test:e2e:ios:local
Run e2e tests locally for Android	npm run native test:e2e:android:local

More details related to how to transition from a gutenberg-mobile setup to the this setup will be given on the gutenberg-mobile PR (note: add link when PR is ready)

How has this been tested?

This branch contains all the following approved PRs:

• [Monorepo][base-branch] import of gutenberg-mobile
• [Monorepo] Split gutenberg-mobile to 3 packages - bridge, editor, aztec
• [Monorepo] Rename react-native-gutenberg-bridge to react-native-bridge
• [Monorepo] Move dependencies to root package.json and change yarn to npm
• [Monorepo] Keep up with gutenberg-mobile and gb master and port react-native-aztec from Flow to js
• [Monorepo] Fix android build
• [Monorepo] Fix iOS build
• [Monorepo] Fix linting
• Fix license check script to ignore sub-dependencies of ignored packages
• [Monorepo] Merge gutenberg-mobile and gutenberg master (again)
• [Monorepo] Fix license check errors in monorepo branch
• [Monorepo] Update from master and fix web e2e tests
• [Monorepo] Use github actions to run React Native e2e tests
• [Monorepo] Integrate with gutenberg-mobile
• [Monorepo] Update from master and gutenberg-mobile develop

The last extra commits should only be updates to pull the latest changes from gutenberg-mobile develop and fix conflicts with gutenberg master.

Screenshots

Here are a few screenshots of the demo app which is part of this PR:

iOS

Android

Types of changes

Releasing a demo version of the react native block editor and improving the native dev experience.

Checklist:

• My code is tested.
• My code follows the WordPress code style.
• My code follows the accessibility standards.
• My code has proper inline documentation.
• I've included developer documentation if appropriate.
• I've updated all React Native files affected by any refactorings/renamings in this PR.

[gziolo]

That was a quick set of fixes, thanks!

Congrats to the whole team for incredible work to make all that happen. I'm looking forward to even closer collaboration moving forward 🎉

[gziolo]

We discussed with @hypest in a private chat what documentation should be improved as a follow-up. We identified:

• https://github.com/WordPress/gutenberg/blob/master/docs/contributors/native-mobile.md
• adding a Getting Started for mobile, like https://github.com/WordPress/gutenberg/blob/master/docs/contributors/getting-started.md, with all the details necessary to run the demo apps(s)

For the web, there is also @wordpress/env package that offers a single command that fires a Docker image with a WordPress instance. It would be great to have something like that (in the future) to share between GitHub's actions and the local environment.

[gziolo]

One more little thing, can you put .npmrc files in 3 new packages like this one:
like: https://github.com/WordPress/gutenberg/blob/feat/import-gutenberg-mobile-no-squash/packages/nux/.npmrc

This will prevent installing package-lock.json files inside them. It all should be handled from one lock file in the monorepo setup.

[ceyhun]

One more little thing, can you put .npmrc files in 3 new packages like this one:
like: /import-gutenberg-mobile-no-squash/packages/nux/.npmrc@feat

Sure 👍 Just added them!