| .circleci | ||
| .vscode | ||
| android | ||
| app | ||
| assets | ||
| build | ||
| common | ||
| docs | ||
| ios | ||
| public | ||
| scripts | ||
| server | ||
| test | ||
| .dockerignore | ||
| .editorconfig | ||
| .eslintignore | ||
| .eslintrc.yml | ||
| .gitattributes | ||
| .gitignore | ||
| .gitlab-ci.yml | ||
| .htmllintrc | ||
| .prettierignore | ||
| .stylelintrc | ||
| browserslist | ||
| CHANGELOG.md | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTORS | ||
| docker-compose.yml | ||
| Dockerfile | ||
| l10n.toml | ||
| LICENSE | ||
| package-lock.json | ||
| package.json | ||
| postcss.config.js | ||
| README.md | ||
| tailwind.config.js | ||
| webpack.config.js | ||
Firefox Send
Docs: FAQ, Encryption, Build, Docker, Metrics, More
Table of Contents
- What it does
- Requirements
- Development
- Commands
- Configuration
- Localization
- Contributing
- Testing
- Deployment
- Android
- License
What it does
A file sharing experiment which allows you to send encrypted files to other users.
Requirements
- Node.js 12.x
- 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/ |
Deployment
see also docs/deployment.md
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