Lightning Components Developer’s Guide

Clouds with binary code floating aboveCloud with binary code floating above

No Results

Search Tips:

  • Please consider misspellings
  • Try different search keywords
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Before You Begin

To work with standalone Lightning apps and components , make sure you have these prerequisites.
  1. Create a Developer Edition organization.
  2. Register a Namespace Prefix.
  3. Enable Lightning Components

Create a Developer Edition Organization

The Lightning Component framework is available with a Developer Edition organization, or DE org for short. DE orgs are multipurpose environments with all of the features and permissions that allow you to develop, package, test, and install apps. If you don’t have one, create it by following these steps.

  1. In your browser, go to http://bit.ly/lightningguide.
  2. Fill in the fields about you and your company.
  3. In the Email field, make sure to use a public address you can easily check from a Web browser.
  4. Type a unique Username. Note that this field is also in the form of an email address, but it does not have to be the same as your email address, and in fact, it’s usually better if they aren’t the same. Your username is your login and your identity on developer.salesforce.com, so you’re often better served by choosing a username such as firstname@lastname.com.
  5. Read and then select the checkbox for the Master Subscription Agreement and then click Submit Registration.
  6. In a moment you’ll receive an email with a login link. Click the link and change your password.

Register a Namespace Prefix

Next, register a namespace prefix. Your namespace prefix must be globally unique across all Salesforce organizations. Namespace prefixes are case-insensitive and have a maximum length of 15 alphanumerical characters.

To register a namespace prefix:
  1. From Setup, click Create | Packages.
  2. Click Edit.

    This button does not appear if you have already configured your developer settings.

    Note

  3. Review the selections necessary to configure developer settings and click Continue.
  4. Enter the namespace prefix you want to register.
  5. Click Check Availability to determine if it is already in use.
  6. Repeat if the namespace prefix you entered is not available.
  7. Click Review My Selections.
  8. Click Save.

Your namespace is used as a prefix to the components and Apex classes you are creating. In addition, use the namespace to address any apps you create by accessing:

https://<mySalesforceInstance>.lightning.force.com/<namespace>/<appName>.app, where <mySalesforceInstance> is the name of the instance hosting your org; for example, na1.

Enable Lightning Components

You must opt in to enable Lightning components for your organization.

  1. From Setup, click Develop | Lightning Components.
  2. Select the Enable Lightning Components checkbox.

    You can’t use Force.com Canvas apps in Salesforce1 if you enable Lightning components. Any Force.com Canvas apps in your organization will no longer work in Salesforce1 if you enable Lightning components.

    Warning

  3. Click Save.