Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dis-moi/extension
:speech_balloon: Never browse alone again
https://github.com/dis-moi/extension
browser-extension context contextual-data contextual-help fact-checking good-first-issue hacktoberfest
Last synced: 15 days ago
JSON representation
:speech_balloon: Never browse alone again
- Host: GitHub
- URL: https://github.com/dis-moi/extension
- Owner: dis-moi
- License: other
- Created: 2015-11-30T16:44:35.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2024-06-30T13:33:58.000Z (6 months ago)
- Last Synced: 2024-07-03T00:49:01.881Z (6 months ago)
- Topics: browser-extension, context, contextual-data, contextual-help, fact-checking, good-first-issue, hacktoberfest
- Language: TypeScript
- Homepage: https://www.dismoi.io/
- Size: 102 MB
- Stars: 42
- Watchers: 11
- Forks: 11
- Open Issues: 226
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: docs/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Dismoi - extension
[](https://semaphoreci.com/lmem/extension)
> _Dis moi_ means _Tell me_ in :fr: French.
**Dismoi** is a web extension that allows anyone to post information directly on any web page you browse.
If you follow an informer, his messages are displayed at the time you visit the pages he has commented on.
To learn more about the uses cases, visit the :fr: [**Dismoi** website](https://www.dismoi.io/).
> At the time of writing, information are stored in database and exposed via the [**Dismoi** Backend](https://github.com/dis-moi/backend).
## Installation
You can find the latest _tests_ version of **Dismoi** extension on the [releases page](https://github.com/dis-moi/extension/releases).
For the latest production version of **Dismoi** extension visit the official addon page of you favorite browser:
- [**Dismoi** Firefox](https://addons.mozilla.org/fr/firefox/addon/dismoi/)
- [**Dismoi** Chrom\*](https://chrome.google.com/webstore/detail/bulles/fpjlnlnbacohacebkadbbjebbipcknbg)
## Build instructions
### Firefox
> *To the attention of the __Mozilla__ addon reviewer.*
>
> To reach *zero diff* with the submitted addon, the addon must be build with __node version `10.15.0`__.
> ```
> yarn install && NODE_ENV=production yarn build:firefox
> ```
> Or just run the build process with `Docker`:
> ```
> yarn build:firefox:production:docker
> ```
> https://extensionworkshop.com/documentation/publish/source-code-submission/
## Permissions
The **Dismoi** extension requires the following permissions :
- `activeTab` The extension is able to follow your navigation on the active tab, when you browse to a new `URL` you may receive a new information.
- `storage` The extension use the [`sync` storage area](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/storage/sync) to store and sync across browser instance the following informations :
- `prefs` The contributions you dismissed, disliked, liked, read. Also if you accepted the :fr: [Term of Service](https://www.dismoi.io/cgu/).
- `subscriptions` Which informers you are following.
- `installationDetails` The extension version, date of installation, date of last update.
- `user` A generated unique identifier.
- `serviceMessage` The last time you saw the service message, to avoid showing it up again.
- `matches: ['*://*/*']` To _potentially_ notify you on any page you are visiting.
> In the near future we wan't to use the [declarative content API](https://developer.chrome.com/extensions/declarativeContent), to avoid injecting Js everywhere and further protect your private life (see #275).
## Development
1. Clone the repository
```bash
git clone [email protected]:dis-moi/extension.git dismoi-extension
```
2. Install [yarn](https://yarnpkg.com/)
> https://classic.yarnpkg.com/en/docs/install
3. Install dependencies
```bash
yarn
```
> To start the `profiles` app in development run the following command
>
> ```
> yarn start:profiles
> ```
4. Create a copy of `.env.development.example` to `.env.development` and adjust the values.
> Read further on [environments](docs/CONTRIBUTING.md#Environments).
5. Start the extension
```bash
yarn start
```
> Watch files changes (but do not reload the content script though)
6. Open [chrome://extensions/](chrome://extensions/),
- activate **Developer mode**
- click **Load unpacked**
- and load `build/development/chromium` folder
> Chrom(e|ium) browser is recommend for development.
> see https://developer.chrome.com/extensions/getstarted#manifest
## Contributing
You’re welcome to help!
> For further reading, refer to the [**Dismoi** contributing guidelines](docs/CONTRIBUTING.md).
## Test
```bash
# test everything
yarn test
```
> For integration tests see https://github.com/dis-moi/extension/pull/289
## Storybook
There is a Storybook for [**Dismoi** components](https://storybook.lmem.net) design, exploration, testing and documentation. It's hot reloaded.
Storybook may be run with the following command:
```bash
yarn storybook
```
It also possible to build a static version, the one you can see here : https://storybook.lmem.net.
You can do this with:
```bash
yarn build-storybook
```
It is automatically deployed to https://storybook.lmem.net on every `develop` branch update.
## Links
- 🌐 Web: https://www.dismoi.io
- 🐦 Twitter: https://twitter.com/DisMoiCompagnon
## LICENSE
[GNU AGPL V3](LICENSE)
> Copyright (C) 2016-2024 ALTERNATIVES NGO
>
> This program is free software: you can redistribute it and/or modify
> it under the terms of the GNU Affero General Public License as published by
> the Free Software Foundation, either version 3 of the License, or
> (at your option) any later version.
>
> This program is distributed in the hope that it will be useful,
> but WITHOUT ANY WARRANTY; without even the implied warranty of
> MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
> GNU AFFERO GENERAL PUBLIC LICENSE for more details.
>
> You should have received a copy of the GNU General Public License
> along with this program. If not, see .