48b5d85904
* (Android) Get rid of double bangs by using Kotlin view binding Instead of holding a nullable reference to the WebView, we are now accessing the WebView using the view binding utility of Kotlin's Android Extensions. Further reading: https://kotlinlang.org/docs/tutorials/android-plugin.html * (Android) Enable WebView debugging in debug builds This enables debugging the app's WebView using Chrome's DevTools. https://developers.google.com/web/tools/chrome-devtools/remote-debugging/webviews * (Android) Make MainActivity.kt adhere to common Kotlin conventions * (Android) Update dependencies and improve formatting of Gradle files This updates the Kotlin plugin to 1.3.21 and the Gradle plugin to 3.3.2 * (Android) Remove unnecessary ConstraintLayout container Layout files should generally have as few nested layers as possible, because every layer affects the performance. * (Android) Use JSONObject class to construct a JSON string It is way safer to construct a JSON string using classes that are meant for doing that, instead of concatenating raw strings. * (Android) Suppress JavaScript lint warning * (Android) Use Kotlin string templates instead of concatenating strings * (Android) Add missing SuppressLint import |
||
|---|---|---|
| .vscode | ||
| android | ||
| app | ||
| assets | ||
| build | ||
| common | ||
| docs | ||
| ios | ||
| public | ||
| scripts | ||
| server | ||
| test | ||
| .dockerignore | ||
| .editorconfig | ||
| .eslintignore | ||
| .eslintrc.yml | ||
| .gitattributes | ||
| .gitignore | ||
| .htmllintrc | ||
| .prettierignore | ||
| .stylelintrc | ||
| CHANGELOG.md | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTORS | ||
| Dockerfile | ||
| LICENSE | ||
| README.md | ||
| browserslist | ||
| circle.yml | ||
| docker-compose.yml | ||
| l10n.toml | ||
| package-lock.json | ||
| package.json | ||
| postcss.config.js | ||
| tailwind.js | ||
| webpack.config.js | ||
README.md
Docs: FAQ, Encryption, Build, Docker, Metrics, More
Table of Contents
- What it does
- Requirements
- Development
- Commands
- Configuration
- Localization
- Contributing
- Testing
- Android
- License
What it does
A file sharing experiment which allows you to send encrypted files to other users.
Requirements
- Node.js 10.0+
- Redis server (optional for development)
- AWS S3 or compatible service. (optional)
Development
To start an ephemeral development server run:
npm install
npm start
Then browse to http://localhost:8080
Commands
| Command | Description |
|---|---|
npm run format |
Formats the frontend and server code using prettier. |
npm run lint |
Lints the CSS and JavaScript code. |
npm test |
Runs the suite of mocha tests. |
npm start |
Runs the server in development configuration. |
npm run build |
Builds the production assets. |
npm run prod |
Runs the server in production configuration. |
Configuration
The server is configured with environment variables. See server/config.js for all options and docs/docker.md for examples.
Localization
Firefox Send localization is managed via Pontoon, not direct pull requests to the repository. If you want to fix a typo, add a new language, or simply know more about localization, please get in touch with the existing localization team for your language or Mozilla’s l10n-drivers for guidance.
see also docs/localization.md
Contributing
Pull requests are always welcome! Feel free to check out the list of "good first issues".
Testing
| ENVIRONMENT | URL |
|---|---|
| Production | https://send.firefox.com/ |
| Stage | https://stage.send.nonprod.cloudops.mozgcp.net/ |
| Development | https://send2.dev.lcip.org/ |
Android
The android implementation is contained in the android directory, and can be viewed locally for easy testing and editing by running ANDROID=1 npm start and then visiting http://localhost:8080. CSS and image files are located in the android/app/src/main/assets directory.
License
Mozilla Public License Version 2.0