Introduction
Thank you for buying Atmosphere. This documentation explains how to install the template, how it is built, and how to change it into your own product.
#What Atmosphere is
Atmosphere is an admin template built with React 19, TypeScript, Vite, Tailwind CSS v4 and React Router 7.
Its look is tactile. Every part of the interface is made from one pale material that is lit from one direction:
- Raised panels stand up from the background, with a soft shadow below and a highlight above.
- Wells are carved into the background. Inputs, status chips and progress tracks are wells.
- Keycaps are buttons with a solid bottom edge. They move down 4px when you press them.
- There are no borders. Depth does that job.
The demo shows Hearth, a smart building run by a small property team: energy, climate zones, devices, work orders, door access and residents. All names and numbers in the demo are invented, and they agree with each other on every page.
#What is in the download
The ThemeForest download has two folders:
atmosphere-1.1.1.zip
Documentation/ # this documentation
index.html # open this file in a browser to start
pages/ # the other documentation pages
assets/ # the style sheet and script for these pages
template/ # the React project
src/
public/
index.html
package.json
README.md # a short version of these pages
...
Everything you build with is inside template/. The documentation does not
need a server or an internet connection. Open
Documentation/index.html directly in your browser.
#Quick start
You need Node.js 20.19 or newer (or 22.12 or newer) and npm.
cd template
npm install
npm run dev
Then open http://localhost:5192 in your browser. The Getting started page explains each step.
#What you get
| Kind | Count | Examples |
|---|---|---|
| Dashboards | 6 | Building overview, energy, solar and storage, air quality, lobby display |
| List pages | 22 | Devices, meters, work orders, visitors, residents, audit log |
| Detail pages | 5 | Device, meter, climate zone, work order, resident |
| Forms and wizards | 5 | Add device, scene editor, visitor pass, announcements, settings |
| Apps | 8 | Inbox, chat, calendar, notes, kanban board, weekly schedule, amenity booking |
| Other pages | 5 | Floor plan, cameras, tariffs, profile, billing |
| Design kit pages | 13 | Buttons, inputs, dials, charts, tables, icons, motion and more |
| Sign-in pages | 7 | Sign in, sign up, forgot and reset password, two-factor, lock screen, invite |
| Error pages | 6 | 401, 403, 404, 500, 503 and maintenance |
It also includes:
- A light theme and a graphite (dark) theme, plus a "System" choice that follows the operating system.
- A compact density for dense screens, a switch for the light direction, a flat key mode, a reduced motion mode and right-to-left layout.
- A command palette on ⌘ K (or Ctrl K) that searches every page.
- Apache ECharts for every chart, recolored live when the theme changes.
- Motion that is part of the design: cards settle in one after another, keys travel, the thermostat needle sweeps, and numbers count up. All of it respects the reduced motion setting.
- WCAG 2.1 AA color contrast in both themes.
#Where to go next
#Before you start
- This is a front-end template. It has no server, database or login system. Forms check their fields in the browser and then show a message. You connect them to your own back end.
- This is a React project. You need to know the basics of React and TypeScript to change it.
- If you get stuck, read the FAQ first. If your question is not there, contact us through the item's comments on ThemeForest. The FAQ explains what to include.