lightning 2.1.3

  • Installing
  • Versions
  • 61

Lightning Dart

Stories in Ready Build Status pub package

Lightning Dart is a library for developing web applications based on the css framework SLDS provides scss/css, icons and fonts, but no functionality.

Lightning Dart provides the most complete component functionality for slds. Written in Dart it compiles into Javascript ("Dart - the better Javascript"), so the delivery is a "one page apps". You can add business functionality by writing the code in Dart - or in Javascript directly - or any language which can call Javascript.

The Framework is not dependent on functionality and can be used independently.

The Salesforce Lightning Design css framework is similar to Bootstrap but uses more recent css technology and concentrates on building Web Applications, not Web Sites.

Lightning Dart is mainly used to generate the user interface manually or from meta data. In addition to that you can create a traditional html layout and then add the component functionality via Dart.

Check out the demo


A simple usage example:

import "package:lightning/lightning.dart";

main() async {
  await LightningDart.init(); // client env
  // example:

For more details, see documentation


Lightning Dart is split up into three parts

  • View - library lightning_dart with entry point LightningDart - can be used independently and provides individual component level functionality
  • Model - library lightning_model uses Protocol Buffers for efficient language independent serialization
  • Controller - library lightning_ctrl with entry point LightningCtrl (instantiates view, ...) provides component group functionality

Status, features and bugs

The Component Demo provides the implementation status per component. The version number reflects the SLAD version.

Please file feature requests and bugs at the issue tracker or send an email to


We welcome help and contributions. The current status of the underlying design system (css) is in flux and can change quickly. So it is best to contact us first ( to coordinate efforts. We require the usual contributor license agreement.



Version numbers are based on the Salesforce Lightning Design System (SLDS) css Framework version numbers. Intermediate Patches, Functionality improvements via +x prefix.


2.1.3 (2016-10-03)

  • SLDS 2.1.3
  • Google Analysis option

2.0.2 (2016-06-29)

  • SLDS v2.0.2 #48
  • Time Series #49
  • Table Layout enhancements #47
  • CSV import #46
  • Workspace Query Enhancements #45

1.0.0 (2016-03-08)

  • SLDS v1.0.0 #44
  • FK Hierarchy Lookup #21
  • Data Graph #40
  • Card Panel #38
  • IE type restrictions #36
  • svg compatibility edge/ie #35
  • color editor #34
  • timezone editor #17
  • AppsAction disabled support
  • icon title, description, link
  • lookup enhancements
  • apps header

0.12.1 (2015-12-21)

  • upgrade to SLDS 0.12.1 #33
  • (Sales) Path #29
  • Default Editor based on Platform #31
  • Messages-Settings-Environment Tab #30
  • lookup enhancements
  • stateful button improvements


  • nested modals #29
  • lookup completed/stabilized
  • Upgrade to SLDS 0.12.0 #25
  • (remote) logging enhancements #27
  • FK editor and dialog with parent values (e.g. contact of account) #20
  • File editor (upload) #19
  • layout fixes


  • lookups, fk search dialog
  • object/record home improvements
  • SLDS v0.10.1


  • improved components and controller
  • form controller logic, validation, error display
  • form in modal
  • SLDS v0.9.2


  • improved components
  • signup form example
  • workspace example
  • SLDS v0.9.1


  • Fixed links, descriptions
  • Improved demo
  • SLDS v0.8.1


  • Initial version based on SLDS v0.8.0

1. Depend on it

Add this to your package's pubspec.yaml file:

  lightning: "^2.1.3"

2. Install it

You can install packages from the command line:

with pub:

$ pub get

Alternatively, your editor might support pub get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:

import 'package:lightning/lightning.dart';
Version Uploaded Documentation Archive
2.1.3 Oct 16, 2016 Go to the documentation of lightning 2.1.3 Download lightning 2.1.3 archive
2.0.2 Jun 30, 2016 Go to the documentation of lightning 2.0.2 Download lightning 2.0.2 archive
1.0.0 Mar 9, 2016 Go to the documentation of lightning 1.0.0 Download lightning 1.0.0 archive
0.12.1 Dec 22, 2015 Go to the documentation of lightning 0.12.1 Download lightning 0.12.1 archive
0.12.0 Dec 2, 2015 Go to the documentation of lightning 0.12.0 Download lightning 0.12.0 archive
0.10.1+0 Oct 23, 2015 Go to the documentation of lightning 0.10.1+0 Download lightning 0.10.1+0 archive
0.9.2+0 Oct 8, 2015 Go to the documentation of lightning 0.9.2+0 Download lightning 0.9.2+0 archive
0.9.1+0 Sep 15, 2015 Go to the documentation of lightning 0.9.1+0 Download lightning 0.9.1+0 archive
0.8.1 Aug 26, 2015 Go to the documentation of lightning 0.8.1 Download lightning 0.8.1 archive
0.8.0 Aug 26, 2015 Go to the documentation of lightning 0.8.0 Download lightning 0.8.0 archive


This feature is new.
We welcome feedback.
More details: scoring.

We analyzed this package, and provided a score, details, and suggestions below.

  • tool failures on Jan 21, 2018
  • Dart: 2.0.0-dev.15.0
  • pana: 0.10.0


Describes how popular the package is relative to other packages. [more]
40 / 100
Code health derived from static analysis. [more]
99 / 100
Reflects how tidy and up-to-date the package is. [more]
56 / 100
Overall score:
Weighted score of the above. [more]


Detected platforms: unsure

Error(s) prevent platform classification.


  • Fix dependencies in pubspec.yaml.

    Running pub upgrade failed with the following output:

    ERR: Package lightning requires SDK version 1.19.1 but the current SDK is 2.0.0-dev.15.0.
  • Fix platform conflicts.

    Make sure none of the libraries use mutually exclusive dependendencies.

  • Fix issues reported by dartanalyzer.

    dartanalyzer reported 1 error(s) and 0 warning(s).

  • Maintain an example.

    None of the files in your example/ directory matches a known example patterns. Common file name patterns include: main.dart, example.dart or you could also use lightning.dart.

  • Use analysis_options.yaml.

    Rename old .analysis_options file to analysis_options.yaml.

  • Enable strong mode analysis.

    Strong mode helps you to detect bugs and potential issues earlier.Start your analysis_options.yaml file with the following:

      strong-mode: true


Package Constraint Resolved Available
Direct dependencies
Dart SDK 1.19.1