https://github.com/segmentio/analytics.js-integrations
Monorepo housing Segment's analytics.js integrations
https://github.com/segmentio/analytics.js-integrations
analyticsjs javascript segment
Last synced: about 2 months ago
JSON representation
Monorepo housing Segment's analytics.js integrations
- Host: GitHub
- URL: https://github.com/segmentio/analytics.js-integrations
- Owner: segmentio
- License: mit
- Created: 2018-05-31T20:53:32.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2025-04-30T13:42:01.000Z (about 2 months ago)
- Last Synced: 2025-05-10T10:05:50.624Z (about 2 months ago)
- Topics: analyticsjs, javascript, segment
- Language: JavaScript
- Homepage: https://segment.com/docs/destinations/
- Size: 5.59 MB
- Stars: 120
- Watchers: 18
- Forks: 144
- Open Issues: 267
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Analytics.js Integrations
## Introduction
This repo stores the majority of the `analytics.js` integrations that Segment currently supports. It is organized as a monorepo with each individual integration packaged and deployed as their own npm modules.
## Getting Started
To start contributing, please ensure you have the following installed on your local machine:
- [yarn](https://yarnpkg.com/en/)
- [node](https://nodejs.org/en/)
Once these pre-requisites are met, feel free to clone the repo locally and install the required dependencies:
```bash
git clone https://github.com/segmentio/analytics.js-integrations && cd analytics.js-integrations
yarn
```
## Contributing
All individual integrations are stored in the `integrations/` directory. We recommend navigating into the individual integration you are contributing to in your terminal rather than working from the root directory:
```bash
cd integrations/
```
### Breaking Changes
Please note, there is currently no way for user's of these integrations to choose specific versions. **Therefore, all changes must always be fully backwards compatible**. If a change is breaking it will not be considered.
### Adding Dependencies
If you need to add an external dependency to an integration, **please ensure you add it within the integration directory, not the root directory**. That being said, please keep in mind that these integrations are run client side. Please only add external dependencies if it is critical to your code changes.
### Running Tests
Each integration directory has an npm script called `test` that you can use to easily run the unit tests with via `yarn test`.
### Test Locally
To test changes locally you can run:
```
yarn --cwd tester install
yarn dev
```
This will open the local development environment. To test a particular destination, enter a writeKey that has the destination connected, and the tool will load Analytics.js with the local version of the destinations connected, and the settings for the source. After the first load, you can referesh the page without having to load the writeKey each time.
If you want to test a new destination or a new settings parameter, you can override the settings using the integrated JSON editor. To fire track, page, etc. calls, you can use the Chrome DevTools and fire events using `analytics.track( .... )` etc.
### Code Formatting
This project uses eslint to ensure uniform code formatting standards are maintained. You can see the specific eslint config in the root `.eslintrc` file. A pre-commit hook is used to help automate this process for you.
### Pull Requests
Please make sure your PR includes the new version in `package.json` as well as an update to the integration's HISTORY.md file describing the change.
### Releasing
All releases are handled by Segment engineers. Releases will be managed after a change has been approved and merged.