/alloy

Alloy is the web SDK for the Adobe Experience Platform.

Primary LanguageJavaScriptApache License 2.0Apache-2.0

Build Status

Alloy

Alloy is the web SDK for the Adobe Experience Platform. It allows for streaming data into the platform, syncing identities, personalizing content, and more. This repository is currently under active development and is not yet intended for general consumption.

For documentation on how to use Alloy, please see the documentation.

Contributing

Contributions are welcomed! Read the Contributing Guide for more information about how our community works.

To get started on development:

  1. Install node.js. If you already have node installed, be sure it is version 12.12.0 or higher.
  2. Clone the repository.
  3. After navigating into the project directory, install project dependencies by running npm install.

Several npm scripts have been provided for assisting in development. Each script can be run by navigating to the cloned repository directory in a terminal and executing npm run scriptname where scriptname is the name of the script you would like to run. The most useful scripts are as follows:

  • dev Spins up a sandbox website where you can manually test the library as though you were a consumer using the library. The sandbox files can be found in the sandbox directory and can be modified to suit your needs.
  • test Runs unit tests against source files. Tests can be found in the test directory.
  • test:watch Same as test, but will re-run the tests as you change source files or test files.
  • lint Analyzes code for potential errors.
  • format Formats code to match agreed-upon style guidelines.

For functional testing, please see the functional testing documentation.

When you attempt to commit code changes, several of the above tasks will be run automatically to help ensure that your changes pass tests and are consistent with agreed-upon standards.

Thank you for your interest in contributing!

Linking to Documentation

If you are writing code that logs a message referring the user to a particular piece of documentation, please link to the documentation using an adobe.ly URL. To make an adobe.ly URL, go to Bitly and shorten the documentation URL. As long as the documentation URL begins with https://www.adobe.io, Bitly should provide you with a short url using the adobe.ly domain.

If you need to change the documentation URL that the adobe.ly URL redirects to, please open an issue in this repository requesting the change.

Requesting Write Access (Adobe Employees)

For Adobe Employees that would like write access to this repository, please follow the instructions found in the GitHub Adobe Org Management document. When you must indicate a team to which your user should be added, please enter adobe|UnifiedJS.

Temporary Workaround for Environments

  1. When configuring Alloy, setedgeDomain to konductor.int.gslb.eegw.adobedc.net.
  2. Open src/constants/domains.js and change adobedc.demdex.net to adobedc-int.demdex.net.
  3. Open src/core/network/createNetwork.js and remove /${edgeBasePath} from the url literal string template.