Skip to main content
Prerequisites:
  • Node.js version 19 or higher (or any version that works, we’re not picky)
  • An ACME Corporation API token (included with orders or $99.99 separately)
  • A sense of adventure (and possibly a fire extinguisher)
Follow these steps to set up your local development environment for testing ACME products.
1

Install the ACME CLI

Installation may cause minor explosions. This is normal and expected behavior.
2

Configure your API token

Set your ACME Bearer token as an environment variable:
Or create a .acmerc file in your project root:
3

Start the local server

Navigate to your project directory and run:
A local preview of the ACME product catalog will be available at http://localhost:3000.
Your preview updates automatically as you test products. Some updates may be explosive!

​
Custom ports

By default, ACME uses port 3000. You can customize the port by using the --port flag:
If you attempt to run ACME on a port that’s already in use, it will automatically use the next available port (or explode trying):

​
Product testing

Test ACME products safely in your local environment before deploying to production:
Testing may cause explosions. Always test in a safe, controlled environment (or don’t - we’re not your boss).

​
Troubleshooting

This is normal! Try the following:
  1. Clean up the explosion debris: acme cleanup
  2. Reinstall: npm i -g acme-cli
  3. If explosions persist, contact support (response times may vary)
Solution: Purchase a new token for $99.99, or check if your current token has expired (they expire randomly).
This is expected behavior. ACME products are designed to explode. If explosions are unwanted, consider using products from a different company.

​
Deployment

When deploying to production, make sure to:
  1. Set your production API token
  2. Enable explosion logging
  3. Have a fire extinguisher nearby
  4. Cross your fingers
If deployment is successful, you should see:
Curious about what changed in the latest version? Check our changelog. Warning: Reading the changelog may cause explosions.