Lightning Components Developer Guide

What is the Lightning Component Framework?
Quick Start
Before You Begin
Create a Standalone Lightning App
Create a Component for Salesforce1 and Lightning Experience
Creating Components
Using Components
Communicating with Events
Creating Apps
Debugging
Reference
PDF

Newer Version Available

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

Before You Begin

To work with Lightning apps and components , follow these prerequisites.
  1. Create a Developer Edition organization
  2. Register a Namespace Prefix
  3. Define a Custom Salesforce Domain Name

For this quick start tutorial, you don’t need to create a Developer Edition organization or register a namespace prefix. But you want to do so if you’re planning to offer managed packages. You can create Lightning components using the UI in Enterprise, Performance, Unlimited, Developer Editions or a sandbox. If you don’t plan to use a Developer Edition organization, you can go directly to Define a Custom Salesforce Domain Name.

Note

Create a Developer Edition Organization

You only need a Developer Edition organization if you plan to offer managed packages.

  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. A namespace prefix is required if you plan to offer managed packages on the AppExchange. 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.

A namespace is not required to create Lightning components but it’s required if you plan to offer managed packages. If your org doesn't have a namespace, you can use the default namespace to access your components.

Note

To register a namespace prefix:
  1. From Setup, enter Packages in the Quick Find box, then select Packages.
  2. Click Edit.

    This button doesn’t appear if you’ve already configured your developer settings.

    Note

  3. Review the selections that are required for configuring developer settings, and then click Continue.
  4. Enter the namespace prefix you want to register.
  5. Click Check Availability to determine if the namespace prefix is already in use.
  6. If the namespace prefix that you entered isn’t available, repeat the previous two steps.
  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://<myDomain>.lightning.force.com/<namespace>/<appName>.app, where <myDomain> is the name of your custom Salesforce domain

Define a Custom Salesforce Domain Name

A custom domain name helps you enhance access security and better manage login and authentication for your organization. If your custom domain is universalcontainers, then your login URL would be https://universalcontainers.lightning.force.com. For more information, see My Domain in the Salesforce Help.