Skip to content
DocsHelp
Help

FAQ and troubleshooting

Answers to the questions buyers ask most, and fixes for common problems. If your question is not here, see Getting support at the end of this page.

#Installing and running

#npm install fails or shows many errors

Check your Node.js version with node -v. Atmosphere needs 20.19 or newer, or 22.12 or newer. Install the current LTS version from nodejs.org, delete node_modules/, and run npm install again.

Use npm, not Yarn or pnpm, for the first install. The project includes a package-lock.json that npm uses to install the exact versions we tested.

#npm shows "deprecated" warnings

These come from packages that other packages use. They are not errors, and the template works. You can ignore them.

#The port is already in use

Another program is using port 5192. Close it, or change server.port in vite.config.ts to another number, such as 5200.

#The fonts look different on my computer

The fonts load from Google Fonts, so they need an internet connection. Without one, the browser uses a system font. To work offline or to avoid Google, host the fonts yourself.

#Building and hosting

#I see a 404 error when I reload a page on my server

Your server does not send unknown paths to index.html. Add the rule for your host from the Deployment page.

#The page is blank after I upload it to a folder

Build again with the folder's path: npm run build -- --base=/your-folder/. See Host in a subfolder.

#Can I open dist/index.html directly from my disk?

No. Browsers block JavaScript modules on file:// pages. Use npm run preview, or any local web server.

#The build fails with TypeScript errors

Run npm run typecheck. It lists each error with its file and line. The template itself builds with no errors, so the problem is in a file you changed.

#Changing the design

#My color change does not show

  • Make sure you changed a role in _roles.css, not a value inside a component.
  • If you use the graphite theme, check _themes.css too. Graphite sets some roles again.
  • Charts read colors from _charts.css.
  • Reload the page with ⌘ Shift R or Ctrl Shift R.

#How do I make the interface flatter?

Lower the shadow strength roles --am-lo, --am-hi, --am-well-lo and --am-well-hi in _roles.css. To stop keys moving, set the Key travel setting to "Flat". See Depth and shadows.

#How do I remove the Appearance drawer?

See Remove the Appearance drawer.

#How do I remove pages I do not need?

See Remove a page.

#Charts

#A chart is empty

A chart needs a width and a height to draw. If you put a chart in a box with no width yet, for example a hidden tab, it draws when the box gets its size. Check that the parent element is visible and has a width. Also check that your data arrays are not empty.

#How do I change chart colors?

Change --am-chart-1 to --am-chart-6 in _charts.css, or pass colors={[...]} to choose different colors for one chart. See Charts.

#Data and back end

#Does Atmosphere include a back end or a database?

No. It is a front-end template. Forms check their fields and show a message, but they do not send anything. See Demo data and your API.

#How do I add login?

See Sign in and protected pages.

#Can I use Atmosphere with Next.js, Vue or Angular?

This item is a React project built with Vite. The components are plain React and can be moved into a Next.js app by hand, but we do not support that setup.

#Updates

#How do I update to a new version?

Download the new version from your ThemeForest Downloads page. Read the Changelog to see which files changed. Then copy those changes into your project.

To make updates easier, keep your own code apart from the template's code where you can: put new pages in new files, and change colors through tokens instead of editing components.

#Getting support

Before you ask, please:

  1. Read the page of this documentation that covers your question.
  2. Check the browser's developer console (F12) for an error message.
  3. Run npm run check to find type and lint errors.

Then contact us through the Comments tab or the Support tab on the item's ThemeForest page. Please include:

  • your Envato purchase code,
  • what you did, what you expected, and what happened,
  • the error message from the console or terminal, if there is one,
  • your Node.js version (node -v), your operating system and your browser.

Item support covers questions about the template's features and help with bugs. It does not cover custom changes, connecting your back end, or third-party code. Envato's item support policy explains the details.