@goastian/amelia
v2.0.1
Published
Simplifying building firefox forks!
Maintainers
Readme
Amelia
Build Midori browsers with ease
This is still in a prerelease / prototype phase.
Installation
npm install @goastian/ameliaDocumentation
Documentation is available on docs.gluon.dev or in the docs folder of this repository.
Application templates
amelia setup-project asks which application base to create:
- Midori Browser, based on Firefox.
- Astian Suite, based on Thunderbird.
Both templates create an amelia.json plus src/, scripts/, patches/,
configs/, build/, and .github/. Thunderbird source downloads are
validated through engine/comm/mail/moz.build and builds are configured with
--enable-project=comm/mail.
For a filesystem with too few inodes to create a full Git snapshot of a source
tarball, set AMELIA_LIGHTWEIGHT_INIT=1 during download or ff-init. This
creates the commit Amelia needs to build, but reset cannot restore stock
source files until the checkout is re-initialised normally.
CI-safe packaging and addons
Special handling for packaging and addons is now integrated in source:
mach packageandmach package-multi-localenow abort explicitly if they fail.- Addon initialization skips git commit when
AMELIA_SKIP_ADDON_GIT_INIT=1or whenCI=true. - Addon mozbuild updates now use
browser/extensions/moz.buildwhen present, fall back tobrowser/extensions/app.mozbuild, and create a base file if needed. - Branding patch fallback now uses
browser/branding/officialwhenbrowser/branding/unofficialdoes not exist.
Usage
Normal local run:
npm run selfCI-safe run (skip addon git commit):
npm run self:ci-safeLicencing notes
The following is included in good faith. The writer is not a lawyer, and this is not legal advice.
Surfer, Gluon and Melon
Amelia is a fork of Surfer and Surfer is based on Gluon but the author has stoped working on it. Gluon has been extracted from melon, the build tool for the desktop version of Dot Browser under MPL v2.0.
This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
Firefox and Thunderbird
This program downloads and modifies Firefox and Thunderbird source. Follow the applicable Mozilla licenses when distributing your program.
