Litestore · Developer docs
Getting started

FAQ

Developers ask these questions most often when they set up, run, change or evaluate Litestore, and each answer is checked against the code.

Developers ask the questions below most often, and each answer has been checked against the code. When a topic has its own page, the answer links to it.

Your server
One Next.js app
Storefront
Admin
Marketing
PostgresOne database
The storefront, the admin and marketing run in one Next.js app on top of one Postgres database.

Setup

Order #1042Paid $120.00
Refunded $80.00Requested $60.00
Write rejectedTotal refunded can't exceed the order total. Nothing was saved.
Postgres rejects a refund that would take more back than the order total.

Running Litestore

Customization

Storefront sections

Storefront pages don't store layout. A page is HTML content followed by an optional product feed, and the routes render them in that order. To add a section, change the code that renders pages. Edit the route, such as app/(web)/page.tsx for the home page, if only one page needs the section. Edit PageContent or PageFeed in modules/storefront/pages/page-view.tsx if every page should get it.

If the section is just text and images, you don't need code at all. An operator can add it to the page's content in the admin, or ask the assistant to write it. Storefront pages explains the rest.

Storefront design

The storefront has one design, and there are no themes. Edit the CSS variables in the @theme block of app/styles.css to change colours, corners and spacing, and edit the storefront components for anything else.

Evaluation

On this page