fox-send/README.md

100 lines
3.2 KiB
Markdown
Raw Normal View History

2017-07-11 19:34:49 +00:00
# Firefox Send
2017-06-26 19:34:31 +00:00
2018-04-01 02:50:45 +00:00
[![BrowserStack Status](https://www.browserstack.com/automate/badge.svg?badge_key=aFFIMHNEWFcrNHJaMU1LRkJnUDhOQkNHMmh2WHBscjJsZHcwK1h0dkhwdz0tLXRpN1RXcysybUtxTFFTVGRtWjVGeHc9PQ==--c56129be8c75941b115c5b5e5d3ed10b3c7dca6b)](https://www.browserstack.com/automate/public-build/aFFIMHNEWFcrNHJaMU1LRkJnUDhOQkNHMmh2WHBscjJsZHcwK1h0dkhwdz0tLXRpN1RXcysybUtxTFFTVGRtWjVGeHc9PQ==--c56129be8c75941b115c5b5e5d3ed10b3c7dca6b)
[![CircleCI](https://img.shields.io/circleci/project/github/mozilla/send.svg)](https://circleci.com/gh/mozilla/send)
[![Available on Test Pilot](https://img.shields.io/badge/available_on-Test_Pilot-0996F8.svg)](https://testpilot.firefox.com/experiments/send)
2017-06-26 19:34:31 +00:00
2018-03-06 00:29:09 +00:00
**Docs:** [FAQ](docs/faq.md), [Encryption](docs/encryption.md), [Build](docs/build.md), [Docker](docs/docker.md), [Metrics](docs/metrics.md), [More](docs/)
---
## Table of Contents
* [What it does](#what-it-does)
* [Requirements](#requirements)
* [Development](#development)
* [Commands](#commands)
* [Configuration](#configuration)
* [Localization](#localization)
* [Contributing](#contributing)
* [Testing](#testing)
* [License](#license)
---
2017-06-26 19:34:31 +00:00
## What it does
2017-07-19 16:23:42 +00:00
A file sharing experiment which allows you to send encrypted files to other users.
2017-06-26 19:34:31 +00:00
---
2017-06-26 19:34:31 +00:00
## Requirements
- [Node.js 10.0+](https://nodejs.org/)
- [Redis server](https://redis.io/) (optional for development)
- [AWS S3](https://aws.amazon.com/s3/) or compatible service. (optional)
2017-06-26 19:34:31 +00:00
---
## Development
To start an ephemeral development server run:
2017-06-26 19:34:31 +00:00
```sh
npm install
npm start
2017-06-26 19:34:31 +00:00
```
2017-08-25 22:41:53 +00:00
Then browse to http://localhost:8080
---
## Commands
2017-06-26 19:34:31 +00:00
| 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.
2017-06-26 19:34:31 +00:00
---
## Configuration
2017-08-27 20:45:38 +00:00
The server is configured with environment variables. See [server/config.js](server/config.js) for all options and [docs/docker.md](docs/docker.md) for examples.
---
2017-06-26 19:34:31 +00:00
## Localization
Firefox Send localization is managed via [Pontoon](https://pontoon.mozilla.org/projects/test-pilot-firefox-send/), 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](https://pontoon.mozilla.org/teams/) for your language or Mozillas [l10n-drivers](https://wiki.mozilla.org/L10n:Mozilla_Team#Mozilla_Corporation) for guidance.
2017-06-26 19:34:31 +00:00
2018-03-06 00:29:09 +00:00
see also [docs/localization.md](docs/localization.md)
---
2017-06-26 19:34:31 +00:00
## Contributing
Pull requests are always welcome! Feel free to check out the list of ["good first issues"](https://github.com/mozilla/send/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22).
2017-06-26 19:34:31 +00:00
---
2017-07-05 16:47:22 +00:00
## Testing
2017-06-26 19:34:31 +00:00
2017-07-05 16:47:22 +00:00
| ENVIRONMENT | URL
|-------------|-----
2017-07-06 19:12:01 +00:00
| Production | <https://send.firefox.com/>
| Stage | <https://send.stage.mozaws.net/>
| Development | <https://send.dev.mozaws.net/>
2017-06-26 19:34:31 +00:00
---
2017-06-26 19:34:31 +00:00
## License
[Mozilla Public License Version 2.0](LICENSE)
---