# Make It Glow - Your First NeoPixel Project

## Overview

https://youtu.be/vCDfyxNFeEw

Add animated programmable lights to your costume or project. This first-timer guide will walk you through the basics and get you up and running in minutes.

You don't need any fancy soldering equipment or programming knowledge -- Adafruit's Circuit Playground Express makes it really simple, so you can spend your time on making your project amazing and unique.

We'll be using NeoPixels in this guide. NeoPixel is a fancy name for lights you can program.

![](https://cdn-learn.adafruit.com/assets/assets/000/090/162/medium800/leds_neopixels_glowing.jpeg?1585936475)

## What You Need

- A Circuit Playground Express
- A battery (unless your project can plug in via USB)
- Some NeoPixel lights
- A bolt-on kit for attaching the lights
- Wire strippers
- A USB cable for programming (some cables are charge-only, you'll need a good one that can pass data)

Adafruit's [Circuit Playground Base Kit](https://www.adafruit.com/product/3517) already comes with a battery holder and batteries, plus a USB cable for programming, so it's perfect for first-timers.&nbsp;

### Circuit Playground Express - Base Kit

[Circuit Playground Express - Base Kit](https://www.adafruit.com/product/3517)
It's the **Circuit Playground Express Base Kit!** &nbsp;It provides&nbsp;the few things you'll need to get started with the new [Circuit Playground Express](https://www.adafruit.com/product/3333).&nbsp;This version of Circuit Playground is super powered, and will...

In Stock
[Buy Now](https://www.adafruit.com/product/3517)
[Related Guides to the Product](https://learn.adafruit.com/products/3517/guides)
![Rectangular case for Circuit Playground Express - Base Kit.](https://cdn-shop.adafruit.com/640x480/3517-04.jpg)

As for the lights: there are so many different kinds to choose from, so it's really up to you! I'll go into more detail later on, but here's a great one to start with.

### Adafruit NeoPixel LED Strip w/ Alligator Clips - 30 LEDs/meter

[Adafruit NeoPixel LED Strip w/ Alligator Clips - 30 LEDs/meter](https://www.adafruit.com/product/3812)
Adding glowy color to your projects has never been easier: no more soldering or stripping wires, clip 'em on and glow! This **Adafruit NeoPixel LED Strip with Alligator Clips** has **30 total LEDs in a "30 LED per meter" spacing** , and is 1 meter long,...

In Stock
[Buy Now](https://www.adafruit.com/product/3812)
[Related Guides to the Product](https://learn.adafruit.com/products/3812/guides)
![Adafruit NeoPixel LED 1 meter Strip with Alligator Clips wired to Circuit Playground, lighting up rainbow](https://cdn-shop.adafruit.com/product-videos/640x480/3812-06.jpg)

If you get parts separate from the Base Kit, be sure to get a good quality data+power USB cable. 75% of issues with a microcontroller are a poor or incorrect USB connection.

### USB cable - USB A to Micro-B

[USB cable - USB A to Micro-B](https://www.adafruit.com/product/592)
This here is your standard A to micro-B USB cable, for USB 1.1 or 2.0. Perfect for connecting a PC to your Metro, Feather, Raspberry Pi or other dev-board or microcontroller

Approximately 3 feet / 1 meter long

Out of Stock
[Buy Now](https://www.adafruit.com/product/592)
[Related Guides to the Product](https://learn.adafruit.com/products/592/guides)
![USB cable - USB A to Micro-B - 3 foot long](https://cdn-shop.adafruit.com/640x480/592-01.jpg)

Adafruit's bolt-on kit is an easy way to securely attach the lights to the Circuit Playground. If you have a soldering iron, you can always solder them instead -- but the bolt-on kit works just as well, and at a bargain price.

### Bolt-On Kit for Circuit Playground, micro:bit, Flora or Gemma

[Bolt-On Kit for Circuit Playground, micro:bit, Flora or Gemma](https://www.adafruit.com/product/4103)
You have a [Circuit Playground Express](https://www.adafruit.com/product/3333), and want to connect some wires to it for adding LEDs or sensors or speakers? You can use our nice alligator clips, but they are a little bulky. If you aren't quite ready to solder to your Playground,...

In Stock
[Buy Now](https://www.adafruit.com/product/4103)
[Related Guides to the Product](https://learn.adafruit.com/products/4103/guides)
![Close up angled shot of a LED strip attached and powered by a circuit playground. ](https://cdn-shop.adafruit.com/640x480/4103-06.jpg)

You'll also need some wire strippers. These will both cut and strip wires of varying sizes. You can't do electronics without wire strippers, and it's amazing how often they come in handy.

### Hakko Professional Quality 20-30 AWG Wire Strippers

[Hakko Professional Quality 20-30 AWG Wire Strippers](https://www.adafruit.com/product/527)
These are the finest wire strippers we have used, and if you have to do a lot of wiring, you will agree! They have soft rounded grips - very comfortable to use, and precision ground notches that do a perfect job every time. No more yanking or twisting to strip wires cleanly and quickly.<br...></br...>

In Stock
[Buy Now](https://www.adafruit.com/product/527)
[Related Guides to the Product](https://learn.adafruit.com/products/527/guides)
![Red and black multi-size wire stripplers, closed](https://cdn-shop.adafruit.com/640x480/527-02.jpg)

# Make It Glow - Your First NeoPixel Project

## Quick Start

![](https://cdn-learn.adafruit.com/assets/assets/000/090/060/medium800/leds_wiring_for_neopixels_bb.jpg?1585696663)

There are three wires we need to attach: red for power, black for ground, and yellow (or sometimes white) for data.&nbsp;

- Red goes from **VOUT** to + **5V**
- Black goes from **GND** to **GND**
- Yellow goes from **A1** to **DIN**

You can plug a battery pack into the battery connector, or plug into the USB port to power your project.&nbsp;

Note: A0 is connected to the speaker, so we suggest using the other pads that are free, like A1.

![](https://cdn-learn.adafruit.com/assets/assets/000/090/225/medium800/leds_00_alligator_clips.jpg?1586360581)

# Make It Glow - Your First NeoPixel Project

## Program with MakeCode

First we'll get a rainbow animation set up, so when we plug in our lights, they'll do something.

Point your browser at [makecode.adafruit.com](https://makecode.adafruit.com/)&nbsp;and then choose&nbsp; **New Project**.

From here, you can click on any of the colored tabs and drag blocks of code onto your workspace, then preview it using the Circuit Playground Express pictured on the left.&nbsp;&nbsp;

## Set Up the Lights

Click **LOOPS** and drag an `on start` block into your workspace.

![leds_mc00_onstart.jpg](https://cdn-learn.adafruit.com/assets/assets/000/090/116/medium640/leds_mc00_onstart.jpg?1585870054)

Click **LIGHT** , and a new tab appears that says **NEOPIXEL**. Click **NEOPIXEL**. Drag `set strip to create strip on A1 with 30 pixels` out and put it inside your `on start` block. If you have more pixels than 30, change this number to however many you have.

![leds_mc01_creatstrip.jpg](https://cdn-learn.adafruit.com/assets/assets/000/090/117/medium640/leds_mc01_creatstrip.jpg?1585870082)

Scroll down a bit in the **NEOPIXEL** tab and find `strip show frame of animation`. Drag this into the `forever` block.

Now, whatever animation is selected will play on your strip. Let's do one more thing: we have lights on the Circuit Playground too. It's easy to make those light up at the same time.

![leds_mc03_frameofanimation.jpg](https://cdn-learn.adafruit.com/assets/assets/000/090/118/medium640/leds_mc03_frameofanimation.jpg?1585870164)

Under the **LIGHT** tab, find `show frame of animation` and drag it into your forever block.&nbsp;

Anything in the **NEOPIXEL** tab applies to your attached strip. Anything in the **LIGHT** tab applies to the lights on the face of the Circuit Playground.

![leds_mc04_frame2.jpg](https://cdn-learn.adafruit.com/assets/assets/000/090/119/medium640/leds_mc04_frame2.jpg?1585870283)

Click **DOWNLOAD**. The file will download to your computer. Plug in your Circuit Playground with a USB cable, and it appears just like a USB thumb drive -- look for **CPLAYBOOT**. Drag the file you just downloaded onto the **CPLAYBOOT** drive, and you're done!

If you don't see **CPLAYBOOT** , try pressing the tiny black reset button in the center of the board. You're looking for all-green-lights on the face of the board, that's how you know you're in the right mode.

![leds_mc05_download.jpg](https://cdn-learn.adafruit.com/assets/assets/000/090/120/medium640/leds_mc05_download.jpg?1585870331)

Note: If you see a drive called&nbsp; **CIRCUITYPY** &nbsp;then press the reset button again (or twice in a row) to get to&nbsp; **CPLAYBOOT**. If you don't seem to get **CPLAYBOOT** showing, be sure you have a known good USB cable that has power and data (not the power only ones that come with phone rechargers).

Head over to this&nbsp;[Intro to MakeCode](https://learn.adafruit.com/makecode/what-is-makecode) guide for more info on getting started with MakeCode. Or, check out the Code Samples page later in this guide for some more project ideas and tutorials.

# Make It Glow - Your First NeoPixel Project

## Connect the Lights

## Alligator Clip Strip
This is the easiest way to hook a light strip up to your Circuit Playground Express.

**With the Circuit Playground powered off** , hook the red clip to **VOUT** , the white clip to **A1** , and the black clip to **G**.

![leds_00_alligator_clips.jpeg](https://cdn-learn.adafruit.com/assets/assets/000/090/099/medium640/leds_00_alligator_clips.jpeg?1585864058)

Now, power up the Circuit Playground via the USB port or by plugging in your battery. Did the lights come on? If so, hooray! Now we can start making stuff.

![leds_01_alligator_usb.jpeg](https://cdn-learn.adafruit.com/assets/assets/000/090/100/medium640/leds_01_alligator_usb.jpeg?1585864073)

![leds_02_alligator_battery.jpeg](https://cdn-learn.adafruit.com/assets/assets/000/090/101/medium640/leds_02_alligator_battery.jpeg?1585864081)

## Troubleshooting

If the lights did not come on:

1. Is your battery switch turned off? Turn it on!
2. Are all your clips firmly on the correct pads, and not touching each other?

If that's not the problem, head back to the MakeCode page and re-upload your code - it might not have worked correctly.

## NeoPixel Dots & Strips

The alligator clip strips are great, and absolutely foolproof, but they aren't really the best LEDs to use in a costume. They'll wiggle right off the first time someone hugs you. They're like kindergarten: easy peezy and fun, but you don't need to stay there too long.

Once you're ready for first grade, you'll need to learn about data flow direction.&nbsp;

### Data Flow Direction

Remember how we clipped the white wire to **A1**? Well, pin **A1** is telling the pixels things like what color to be, how bright, and how fast to change colors.&nbsp;

The NeoPixel strips "listen" for this data and then pass it down the strip. However, it can only pass the info in one direction: from **IN** to **OUT**. This means that if you hook up the wrong end of the strip, it won't light up.&nbsp;

You won't break your strip if you do this -- we've all done it, there's nothing to be afraid of except a whole bunch of extra work. But it's best to get it right the first time, yes?&nbsp;&nbsp;

Interestingly, the red and black wires don't have this issue -- power and ground can connect to either end of the strip (or somewhere in the middle, if you like). However, it's a wee bit dangerous to have just one of them hooked up and not the other, if the project is powered on, so be sure you're not connected to your battery or computer while you're messing with these wires.

Most of Adafruit's strip-style NeoPixels come with a 2-pin connector and a loose red wire and black wire sticking out of the casing. The spools are generally wound with the **IN** end on the outside, with a female connector, and the **OUT** end near the center of the spool, with a male connector.&nbsp;

![leds_03pixel_spool.jpg](https://cdn-learn.adafruit.com/assets/assets/000/090/104/medium640/leds_03pixel_spool.jpg?1585864790)

This is not always the case! For example, the neon strips have completely different 3-pin connectors with the male on the **IN** end. The NeoPixel dots also have a 3-pin connector, but the **IN** connector is female. This is why it's always important to check which direction they go -- if you hook them up backwards, they won't work.

NeoPixel strips have a little arrow on them showing the direction of data flow. Connect to the end the arrows are coming from, and your data info will follow the flow of the arrows.

![leds_direction_arrows.jpg](https://cdn-learn.adafruit.com/assets/assets/000/090/105/medium640/leds_direction_arrows.jpg?1585865436)

NeoPixel dots have the word **IN** printed on the back of the pixel on one side. It's hard to see. If you can't tell, and you're just not sure, lay the pixel dots face up with the strip flowing away from you. If the red wire is on the left, you're holding the **IN** end. If it's on the right, you're holding **OUT**. Or look for the male connector, it's usually on the **IN** end.

![leds_direction_dots.jpg](https://cdn-learn.adafruit.com/assets/assets/000/090/106/medium640/leds_direction_dots.jpg?1585865529)

The Neon strips have no indicator whatsoever, so you just have to guess. But it doesn't hurt the pixels if you get it wrong -- just be sure to test before installing in your project!

## Hooking Up with the Bolt-On Kit
Get out your bolt-on kit. It comes with four screws and four bolts that are just the right size to fit through the Circuit Playground's mounting holes. We'll need just three of them (so if you dropped one on the floor and lost it in the carpet, no worries).

![leds_06_bolt-on_kit_cpx.jpeg](https://cdn-learn.adafruit.com/assets/assets/000/090/109/medium640/leds_06_bolt-on_kit_cpx.jpeg?1585866690)

Once you've found the **IN** end of your strip, cut off the connector. If there's an extra black wire, you can trim that one off as well. You want to be left with a red wire, a white wire, and a black wire.

![leds_04_wires_cut.jpeg](https://cdn-learn.adafruit.com/assets/assets/000/090/107/medium640/leds_04_wires_cut.jpeg?1585866552)

Now use our wire strippers to strip about 1/4" of shielding off each of these three wires.

![leds_05_wires_stripped.jpeg](https://cdn-learn.adafruit.com/assets/assets/000/090/108/medium640/leds_05_wires_stripped.jpeg?1585866660)

Twist the stripped wires together and stick the red wires through the **VOUT** hole, the white wires through **A1** , and the black wire through **GND**.

If you're using NeoPixel dots, the red wire goes to **VOUT** , the middle wire to **A1** , and the remaining wire goes to **GND.**

![leds_06_wires_on.jpeg](https://cdn-learn.adafruit.com/assets/assets/000/090/110/medium640/leds_06_wires_on.jpeg?1585866749)

Now, stick the bolts through the holes and secure them with the little nuts on the back. It helps to use a screwdriver to tighten them down. You don't need them to be super tight -- finger-tight is fine. The idea is just to hold the wires firmly in place against the pads.

![leds_07_bolts_on.jpeg](https://cdn-learn.adafruit.com/assets/assets/000/090/111/medium640/leds_07_bolts_on.jpeg?1585866798)

Power up your Circuit Playground and watch the lights glow! This configuration is much sturdier than the alligator clip method, and will easily hold up to costume usage.

![leds_09_pixelstrip_on.jpeg](https://cdn-learn.adafruit.com/assets/assets/000/090/113/medium640/leds_09_pixelstrip_on.jpeg?1585866896)

# Make It Glow - Your First NeoPixel Project

## Choose your Pixel Type

NeoPixels come in so many types. [You can see all Adafruit's NeoPixel products here](https://www.adafruit.com/category/168). I'll describe a few of the more commonly used types for wearables and cosplay, with pros and cons for each.

## Strips

These are the most common type of NeoPixels. They come in a variety of widths and spacing. The most common are [30 lights/meter](https://www.adafruit.com/product/1376) or [60 lights/meter](https://www.adafruit.com/product/1138), though you can also get the super-dense [144/m strip](https://www.adafruit.com/product/1506).&nbsp;

The denser strips are more expensive, both in terms of how much they cost and also how much power they use -- your battery will last longer if you have dozens of LEDs instead of hundreds in your project.

[Here's a quick video demonstrating the different densities.](https://www.youtube.com/watch?v=aSQyEup9aZ4&list=PLjF7R1fz_OOU_teVba8A6FUJVV1AfE3Qy&index=20&t=0s)

### Adafruit NeoPixel Digital RGB LED Strip - White 60 LED

[Adafruit NeoPixel Digital RGB LED Strip - White 60 LED](https://www.adafruit.com/product/1138)
You thought it couldn't get better than [our world-famous 32-LED-per-meter Digital LED strip](http://adafruit.com/products/306) but we will prove you wrong! You wanted **twice the LEDs**? We got it (well, its 1.875 times as many but that's within a margin of...

In Stock
[Buy Now](https://www.adafruit.com/product/1138)
[Related Guides to the Product](https://learn.adafruit.com/products/1138/guides)
![Adafruit NeoPixel Digital RGB LED Strip reel wired to a microcontroller, with all the LEDs in a rainbow](https://cdn-shop.adafruit.com/640x480/1138-00.jpg)

#### Projects that Use NeoPixel Strips

- [FireWalker Sneakers](https://learn.adafruit.com/gemma-led-sneakers)
- [FloraBrella](https://learn.adafruit.com/florabrella)
- [Wizard Staff](https://learn.adafruit.com/burning-fire-wizard-staff)
- [Raver Bandolier](https://learn.adafruit.com/cosplay-glow-fur-raver-bandolier)
- [Bunny Ears](https://learn.adafruit.com/bunny-ears-with-makecode)
- [Wonder Woman Bracers](https://learn.adafruit.com/wonder-woman-cosplay-bracers)

## Dots

These are my favorite lights for cosplay applications. They are really tough! Each light is fully encased in plastic, so these light strands are really hard to break. I've even used them underwater. Adafruit sells them in [2" spacing](https://www.adafruit.com/product/3630) or [4" spacing](https://www.adafruit.com/product/3631).

### Adafruit NeoPixel LED Dots Strand - 20 LEDs at 2" Pitch

[Adafruit NeoPixel LED Dots Strand - 20 LEDs at 2" Pitch](https://www.adafruit.com/product/3630)
Attaching NeoPixel strips to your costume can be a struggle as the flexible PCBs can crack when bent too much. So how to add little dots of color? Use these stranded NeoPixel dots! They're very small, so they're easy to embed into any structure, costume, or wearable. Each dot is...

In Stock
[Buy Now](https://www.adafruit.com/product/3630)
[Related Guides to the Product](https://learn.adafruit.com/products/3630/guides)
![Adafruit NeoPixel LED Dots Strand - 20 LEDs at 2 inch Pitch](https://cdn-shop.adafruit.com/640x480/3630-02.jpg)

#### Projects that use NeoPixel Dots

- [Fairy Crown](https://learn.adafruit.com/neopixel-fairy-crown)
- [Motion Reactive Tutu](https://learn.adafruit.com/dance-reactive-tutu-sparkle-skirt)
- [Sparkle Skirt](https://learn.adafruit.com/sparkle-skirt-playground)
- [Rainbow Hoodie](https://learn.adafruit.com/rainbow-chakra-led-hoodie)
- [Magic Light Bag](https://learn.adafruit.com/magic-light-bag-of-holding)

## Rings & Pixels

Sometimes you want a small form-factor or just a few small lights. NeoPixel rings or pixels can be perfect for making light-up gadgets. They come in a variety of sizes: [12 pixel/ring](https://www.adafruit.com/product/1643), [16 pixel/ring](https://www.adafruit.com/product/1463), [24 pixel/ring](https://www.adafruit.com/product/1586), or a giant [60 pixel/ring](https://www.adafruit.com/product/2874) size.

You can also get a 7-pixel [NeoPixel Jewel](https://www.adafruit.com/product/2226) which is perfect for necklaces or very small projects, or [individual NeoPixels](https://www.adafruit.com/product/1559) -- single pixels you can place exactly where you want.

**These pixels are a bit more advanced to use and will require some soldering to get them working.&nbsp;**

These are also available in both RGB and RGBW versions.

[Much more about rings here!](https://learn.adafruit.com/adafruit-neopixel-uberguide/neopixel-rings)

### NeoPixel Ring - 16 x 5050 RGB LED with Integrated Drivers

[NeoPixel Ring - 16 x 5050 RGB LED with Integrated Drivers](https://www.adafruit.com/product/1463)
Round and round and round they go! 16 ultra bright smart LED NeoPixels are arranged in a circle with 1.75" (44.5mm) outer diameter. The rings are 'chainable' - connect the output pin of one to the input pin of another. Use only one microcontroller pin to control as many as you can...

In Stock
[Buy Now](https://www.adafruit.com/product/1463)
[Related Guides to the Product](https://learn.adafruit.com/products/1463/guides)
![Hand holding NeoPixel Ring with 16 x 5050 RGB LED, lit up rainbow](https://cdn-shop.adafruit.com/640x480/1463-00.jpg)

#### Projects that Use Rings & Pixels

- [Ring Bracelet](https://learn.adafruit.com/neopixel-ring-bangle-bracelet)
- [Superhero Power Gauntlet](https://learn.adafruit.com/superhero-power-gauntlet)
- [Kaleidoscope Eyes Goggles](https://learn.adafruit.com/kaleidoscope-eyes-neopixel-led-goggles-trinket-gemma)
- [NeoPixel Jewel Necklace](https://learn.adafruit.com/10-minute-neopixel-necklace)
- [Color Touch Necklace](https://learn.adafruit.com/gemma-color-touch-pendant-necklace)
- [Luminary Lanterns](https://learn.adafruit.com/bluefruit-luminary-lanterns-with-capacitive-touch)

## Specialty

Here are a few other types of NeoPixel strip that exist!

- [UV Blacklight Pixels](https://www.adafruit.com/product/3851): these do not show color, only UV purple, but they're still programmable in that you can change brightness and run animations on the strip. [UV Parasol Project](https://learn.adafruit.com/personal-blacklight-uv-parasol)
- [Side Light Pixels](https://www.adafruit.com/product/3636): Similar to the LED strips above, but laid out so the lights shine to the side. This is useful for projects that need to bend the strips in another way. [LED Corset Project](https://learn.adafruit.com/led-corset-with-circuit-playground-and-makecode)
- [Neon-Look Strip](https://www.adafruit.com/product/4310): These strips are encased in a diffuser that make them look like neon, and they're really flexible and bendy.&nbsp; [Mickey Ears Project](https://learn.adafruit.com/neopixel-led-mickey-ears)

[Find out much more in the NeoPixel UberGuide.](https://learn.adafruit.com/adafruit-neopixel-uberguide/the-magic-of-neopixels)

# Make It Glow - Your First NeoPixel Project

## Batteries & Power

Here are a few battery choices that work well for cosplay or wearable applications.&nbsp;

If your project has more than a couple hundred pixels, you'll want to head over to the [NeoPixel Überguide Power Page](https://learn.adafruit.com/adafruit-neopixel-uberguide/powering-neopixels) to delve a little deeper. Powering is easy for small projects, a bit more involved for big ones.

For smaller costume-sized projects, read on!

## AAA Battery Pack
### 3 x AAA Battery Holder with On/Off Switch and 2-Pin JST

[3 x AAA Battery Holder with On/Off Switch and 2-Pin JST](https://www.adafruit.com/product/727)
This battery holder connects 3 AAA batteries together in series for powering all kinds of projects. We spec'd these out because the box is slim, and 3 AAA's add up to about 3.3-4.5V, a very similar range to Lithium Ion/polymer (Li-Ion) batteries and have an on-off switch. That makes...

In Stock
[Buy Now](https://www.adafruit.com/product/727)
[Related Guides to the Product](https://learn.adafruit.com/products/727/guides)
![Front angled shot of 3 x AAA battery holder with on-off switch and 2-pin JST PH connector.](https://cdn-shop.adafruit.com/640x480/727-07.jpg)

This battery pack is perfect for most costume projects. It has an on/off switch, which is super handy, and it will power hundreds of pixels for a couple hours (depending on brightness, colors, temperature, phase of the moon and luck). The nicest thing is that if your batteries die, it's easy to find new ones.

Don't use rechargeables! They don't provide quite enough voltage.

## Coin Cell Battery Pack
### 2 x CR2032 Coin Cell Battery Holder - 6V output - On/Off switch

[2 x CR2032 Coin Cell Battery Holder - 6V output - On/Off switch](https://www.adafruit.com/product/783)
This tiny coin cell battery holder is ideal for small portable or wearable projects. It holds two 20mm coin cells (2032 or CR2032 are the most popular size) in series to generate 6V nominal. (If you want only 3V, we suggest sticking a crumpled piece of tin foil in one of the slots.) 20mm coin...

In Stock
[Buy Now](https://www.adafruit.com/product/783)
[Related Guides to the Product](https://learn.adafruit.com/products/783/guides)
![Angled shot of closed 2 x 2032 coin cell battery holder with on-off switch and JST PH Connector.](https://cdn-shop.adafruit.com/640x480/783-03.jpg)

If your project is really tiny -- say, you just want to power the Circuit Playground itself and the lights on the face, or you have just one or two pixels, this is a perfect solution. It's got an on/off switch! And it's really tiny and easy to hide. It won't last all night with more than one or two pixels on, but.. sometimes that's all you need! And it's fairly easy to find replacement batteries when you need them.

## Lithium Polymer Batteries
### Lithium Ion Battery - 3.7V 2000mAh

[Lithium Ion Battery - 3.7V 2000mAh](https://www.adafruit.com/product/2011)
Lithium-ion polymer (also known as 'lipo' or 'lipoly') batteries are thin, light, and powerful. The output ranges from 4.2V when completely charged to 3.7V. This battery has a capacity of 2000mAh. If you need a larger (or smaller!) battery,&nbsp;<a...></a...>

Out of Stock
[Buy Now](https://www.adafruit.com/product/2011)
[Related Guides to the Product](https://learn.adafruit.com/products/2011/guides)
![Lithium Ion Polymer Battery 3.7v 2000mAh with JST 2-PH connector](https://cdn-shop.adafruit.com/640x480/2011-05.jpg)

I love these batteries for their tiny tiny size. They last several hours powering most smaller projects, and they're so thin that they can be worn inside a bra or hat band without leaving a big bulky silhouette. These are more or less the same batteries used to power cell phones.

They come in [a good variety of shapes and sizes](https://www.adafruit.com/?q=lithium), from tiny necklace-sized ones to big 2500mAh batteries that will power your LED vest all night long.&nbsp;

A warning: lithium polymer batteries can be dangerous! They can catch on fire if they get punctured and/or wet.&nbsp;

Read that again.

Now, make sure you're not going to fall in the pool or the ocean with this battery strapped in your armpit. If you're good to go, I have one more warning:

These little wires break off ALL THE TIME. They are not attached very well, and have absolutely no defense against flexing. Luckily there's an easy fix: put a rubber band around the battery, trapping the wires inside, so any pulling will be relieved by the rubber band.

Do this the minute you take the battery out of its shipping box! Don't wait.&nbsp;

![leds_battery_rubberband.jpeg](https://cdn-learn.adafruit.com/assets/assets/000/090/114/medium640/leds_battery_rubberband.jpeg?1585868407)

### Charging Lithium Polymer Batteries

Charge these batteries up with one of these Micro Lipo chargers. It plugs into your USB port. It'll charge any of the LiPoly batteries that Adafruit sells, and there's a little bridge-able solder pad on the back which will make it charge larger-sized batteries more quickly.&nbsp;

### Adafruit Micro Lipo - USB LiIon/LiPoly charger

[Adafruit Micro Lipo - USB LiIon/LiPoly charger](https://www.adafruit.com/product/1304)
Oh so adorable, this is the tiniest little lipo charger, so handy you can keep it any project box! Its also easy to use. Simply plug in the gold plated contacts into any USB port and a 3.7V/4.2V lithium polymer or lithium ion rechargeable battery into the JST plug on the other end. There are...

Out of Stock
[Buy Now](https://www.adafruit.com/product/1304)
[Related Guides to the Product](https://learn.adafruit.com/products/1304/guides)
![Top view of Adafruit Micro Lipo - USB LiIon/LiPoly charger - v1 above a 2-pin JST cable.](https://cdn-shop.adafruit.com/640x480/1304-06.jpg)

You can find out much more about this type of battery here: [LIon and LiPoly Batteries Guide](https://learn.adafruit.com/li-ion-and-lipoly-batteries)

# Make It Glow - Your First NeoPixel Project

## Terminology

Here's what All the Words mean. Take a minute to read through so you have a handle on the basics.

### NeoPixel

Programmable lights with three wire connections: power, ground, and data. These are really common, and come in lots of different form factors so they're a great place to start.

### Microcontroller

The mini-computer that tells the LEDs what to do. The [Circuit Playground Express](https://www.adafruit.com/product/3333) is the microcontroller we're using in this guide.

### Power & Ground

The two wire connections that make electricity flow. Power is almost always the red wire, or a **+** , or labeled **VOUT** , and Ground is almost always the black wire, or a **-** , or labeled **G**.

You can connect power and ground to either end of of your NeoPixel strip, or to the middle, or basically anywhere you'd like, but it's important to NOT get them mixed up. Hooking these two up backwards is the quickest way to fry your project.

**Data IN/OUT**

The third wire connection, which tells the LEDs what color to be, how bright, etc. This wire (often white or yellow) hooks up to one of the pads on your microcontroller. Labeled **IN** or **OUT** on the pixel strips.&nbsp;

Data must flow from **IN** (at the microcontroller end) to **OUT** , or the strips won't light up. There's no danger of frying your project if you hook this up wrong, it simply won't work.

## RGB vs RGBW

When you're shopping for NeoPixels, you'll find them in both RGB and RGBW varieties. If you're just starting out, I recommend sticking with RGB for now -- not all programming applications support RGBW since they're still pretty new (at the time of writing).&nbsp;

What's the difference? The W stands for white, and the RGBW lights have four LEDs inside each pixel: red, green, blue, and white, instead of just the 3 red, green, and blue LEDs inside RGB pixels. You'd want to use RGBW if you're trying for a specific white-light look (though RGBs will make white light as well).

# Make It Glow - Your First NeoPixel Project

## Code Samples

There are more and more MakeCode examples available every day. I've listed some of my favorites in the sidebar, and there are new ones being added almost every week. Just search "MakeCode" in the Learn System search bar to dive in.

Also, check out John Park's [MakeCode Minute YouTube Series](https://www.youtube.com/playlist?list=PLjF7R1fz_OOU5gFO10qxLlbtN0YzZTyvk) for more tips and tricks than you can shake a stick at.&nbsp;

Have fun making things light up, and post lots of pictures of your costumes!

# Make It Glow - Your First NeoPixel Project

## NeoPixels with MakeCode

# Make It Glow - Your First NeoPixel Project

## NeoPixel Strand with Light Sensing

# Make It Glow - Your First NeoPixel Project

## Simple Fascinator Hat

# Make It Glow - Your First NeoPixel Project

## Bunny Ears with Motion Reaction

# Make It Glow - Your First NeoPixel Project

## LED Spats with Gradient Color

# Make It Glow - Your First NeoPixel Project

## Motion Reactive Umbrella

# Make It Glow - Your First NeoPixel Project

## Umbrella with Light Modes

# Make It Glow - Your First NeoPixel Project

## Steven Universe Gem Cosplay

# Make It Glow - Your First NeoPixel Project

## Steven Universe Gauntlet Cosplay

# Make It Glow - Your First NeoPixel Project

## UV Umbrella Hotspot

# Make It Glow - Your First NeoPixel Project

## Crystal Staff with Motion Reaction

# Make It Glow - Your First NeoPixel Project

## Flame Effect Dragon

# Make It Glow - Your First NeoPixel Project

## LED Corset


## Featured Products

### Circuit Playground Express

[Circuit Playground Express](https://www.adafruit.com/product/3333)
 **Circuit Playground Express** is the next step towards a perfect introduction to electronics and programming. We've taken the original Circuit Playground Classic and made it even better! Not only did we pack even more sensors in, we also made it even easier to...

In Stock
[Buy Now](https://www.adafruit.com/product/3333)
[Related Guides to the Product](https://learn.adafruit.com/products/3333/guides)
### Bolt-On Kit for Circuit Playground, micro:bit, Flora or Gemma

[Bolt-On Kit for Circuit Playground, micro:bit, Flora or Gemma](https://www.adafruit.com/product/4103)
You have a [Circuit Playground Express](https://www.adafruit.com/product/3333), and want to connect some wires to it for adding LEDs or sensors or speakers? You can use our nice alligator clips, but they are a little bulky. If you aren't quite ready to solder to your Playground,...

In Stock
[Buy Now](https://www.adafruit.com/product/4103)
[Related Guides to the Product](https://learn.adafruit.com/products/4103/guides)
### Adafruit NeoPixel LED Strip w/ Alligator Clips - 30 LEDs/meter

[Adafruit NeoPixel LED Strip w/ Alligator Clips - 30 LEDs/meter](https://www.adafruit.com/product/3812)
Adding glowy color to your projects has never been easier: no more soldering or stripping wires, clip 'em on and glow! This **Adafruit NeoPixel LED Strip with Alligator Clips** has **30 total LEDs in a "30 LED per meter" spacing** , and is 1 meter long,...

In Stock
[Buy Now](https://www.adafruit.com/product/3812)
[Related Guides to the Product](https://learn.adafruit.com/products/3812/guides)
### Adafruit NeoPixel LED Strip w/ Alligator Clips - 60 LED/m

[Adafruit NeoPixel LED Strip w/ Alligator Clips - 60 LED/m](https://www.adafruit.com/product/3811)
Adding glowy color to your projects has never been easier: no more soldering or stripping wires, clip 'em on and glow! This **Adafruit NeoPixel LED Strip with Alligator Clips** has **30 total LEDs** in a **"60 LED per meter" spacing** , and...

In Stock
[Buy Now](https://www.adafruit.com/product/3811)
[Related Guides to the Product](https://learn.adafruit.com/products/3811/guides)
### Adafruit NeoPixel LED Dots Strand - 20 LEDs at 2" Pitch

[Adafruit NeoPixel LED Dots Strand - 20 LEDs at 2" Pitch](https://www.adafruit.com/product/3630)
Attaching NeoPixel strips to your costume can be a struggle as the flexible PCBs can crack when bent too much. So how to add little dots of color? Use these stranded NeoPixel dots! They're very small, so they're easy to embed into any structure, costume, or wearable. Each dot is...

In Stock
[Buy Now](https://www.adafruit.com/product/3630)
[Related Guides to the Product](https://learn.adafruit.com/products/3630/guides)
### Adafruit NeoPixel LED Dots Strand - 20 LED 4" Pitch

[Adafruit NeoPixel LED Dots Strand - 20 LED 4" Pitch](https://www.adafruit.com/product/3631)
Attaching NeoPixel strips to your costume can be a struggle as the flexible PCBs can crack when bent too much. So how to add little dots of color? Use these stranded NeoPixel dots! They're very small, so they're easy to embed into any structure, costume, or wearable. Each dot is...

In Stock
[Buy Now](https://www.adafruit.com/product/3631)
[Related Guides to the Product](https://learn.adafruit.com/products/3631/guides)
### Flexible Silicone Neon-like Skinny NeoPixel LED Strip

[Flexible Silicone Neon-like Skinny NeoPixel LED Strip](https://www.adafruit.com/product/4310)
You love NeoPixels, and you love silicone diffusion? Peep this&nbsp; **Flexible Silicone Neon-like Skinny NeoPixel LED Strip**! OK it's a bit of a mouthful, but check out the beautiful footage! It&nbsp;_looks_&nbsp;a lot like a slim strip of neon, but without the need...

In Stock
[Buy Now](https://www.adafruit.com/product/4310)
[Related Guides to the Product](https://learn.adafruit.com/products/4310/guides)
### 3 x AAA Battery Holder with On/Off Switch and 2-Pin JST

[3 x AAA Battery Holder with On/Off Switch and 2-Pin JST](https://www.adafruit.com/product/727)
This battery holder connects 3 AAA batteries together in series for powering all kinds of projects. We spec'd these out because the box is slim, and 3 AAA's add up to about 3.3-4.5V, a very similar range to Lithium Ion/polymer (Li-Ion) batteries and have an on-off switch. That makes...

In Stock
[Buy Now](https://www.adafruit.com/product/727)
[Related Guides to the Product](https://learn.adafruit.com/products/727/guides)

## Related Guides

- [Adafruit Circuit Playground Express](https://learn.adafruit.com/adafruit-circuit-playground-express.md)
- [Laser Dog Goggles](https://learn.adafruit.com/laser-dog-goggles.md)
- [Wireless Control Button for WLED Projects](https://learn.adafruit.com/wireless-control-button-for-wled-projects.md)
- [MakeCode for Circuit Playground Express](https://learn.adafruit.com/makecode.md)
- [Glowing Bottle Castle and Capacitive Touch Piano](https://learn.adafruit.com/glowing-bottle-castle-and-capacitive-touch-piano.md)
- [Circuit Playground Express Perk-up Ears](https://learn.adafruit.com/perk-up-ears.md)
- [MicroBlocks Circuit Playground Express Ornament](https://learn.adafruit.com/microblocks-circuitplayground-express-ornament.md)
- [TFT Gizmo Animated Eye](https://learn.adafruit.com/tft-gizmo-animated-eye.md)
- [Crickit Controlled Animatronic Eyeball](https://learn.adafruit.com/crickit-controlled-animatronic-eyeball.md)
- [Sensor Plotting with Mu and CircuitPython](https://learn.adafruit.com/sensor-plotting-with-mu-and-circuitpython.md)
- [FruitBox Sequencer: Musically Delicious Step Pattern Generator ](https://learn.adafruit.com/circuitpython-fruitbox-sequencer-musically-delicious-step-pattern-generator.md)
- [Make It a Keyboard](https://learn.adafruit.com/make-it-a-keyboard.md)
- [Zelda: Breath of the Wild – 3D Printed Bladesaw](https://learn.adafruit.com/bladesaw.md)
- [NeoPixel Basketball Hoop](https://learn.adafruit.com/neopixel-mini-basketball-hoop.md)
- [Cosplay Floating LED Fireball with Motion Sensing](https://learn.adafruit.com/cosplay-fireball-prop-with-motion-sensing.md)
- [Celebration Spectacles](https://learn.adafruit.com/celebration-spectacles.md)
