terminalGETTING_STARTED_v1.0

Introduction

Layero is a marketplace of precision-built Next.js themes designed for high-performance websites. Each theme ships production-ready — TypeScript, Tailwind CSS, SEO and CMS connectors included.

codeSTART (Theme Only) is for

  • checkDevelopers
  • checkFreelancers
  • checkAgencies
  • checkTechnical DIY users

support_agentNot technical?

No problem. Our managed plans handle everything — from installation to launch and editing.

PRO Planwe deploy for you

MAX Plandeploy + editable interface

ULTRAfully tailored solution

01. Purchase

Choose a theme and select your plan — START, PRO, or MAX.

02. Configure

Clone the repo, install dependencies, and set your environment variables in .env.local.

03. Customise

Edit content in the data/ folder, swap images, and adjust the Tailwind theme tokens.

04. Deploy

Push to Vercel, Netlify, or upload a static build to your Apache / cPanel hosting.

REQUIREMENTS

Node.js ≥ 18.17, npm ≥ 9 or pnpm ≥ 8. Git is required to clone and track your project.

Installation

After purchasing, you will receive download access to your theme's source repository. Follow the steps below to initialise your local environment.

Terminalbash
# Clone your purchased theme git clone https://github.com/sitelift/your-theme.git # Enter the project directory cd your-theme # Install dependencies npm install # Copy the environment template cp .env.example .env.local # Start the dev server npm run dev

Open http://localhost:3000 to see your theme running locally.

ENVIRONMENT VARIABLES

Edit .env.local with your credentials before running:

# Site config NEXT_PUBLIC_SITE_URL=https://yourdomain.com NEXT_PUBLIC_SITE_NAME="Your Business" # CMS (optional) CONTENTFUL_SPACE_ID=xxxx CONTENTFUL_ACCESS_TOKEN=xxxx # Stripe (optional) STRIPE_SECRET_KEY=sk_live_xxxx NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_live_xxxx

File Structure

All Layero themes follow a consistent directory layout based on the Next.js App Router conventions.

Project Root
. ├─ app/ # Next.js App Router │ ├─ (routes)/ # Page route groups │ ├─ api/ # Server API routes │ ├─ globals.css # Tailwind + design tokens │ └─ layout.tsx # Root layout + fonts ├─ components/ # Shared UI components ├─ data/ # ← All editable content lives here │ ├─ site.ts # Business info, contact, hours │ ├─ services.ts # Services / offerings (theme-specific) │ ├─ team.ts # Team profiles │ └─ ... # Additional files per theme ├─ hooks/ # Custom React hooks ├─ lib/ # SEO helpers, form utils, animations ├─ public/ # Static assets ├─ tailwind.config.ts # Design token overrides └─ .env.local # Your environment secrets
data/site.ts

Business name, phone, email, address, hours and site-wide stats. The first file to open after purchasing a theme.

data/

All editable content split into focused typed files. Each theme documents its own data files in its README — open it for the full list.

app/globals.css

Tailwind @theme block containing all design tokens — colors, type scales, spacing, and border radii.

tailwind.config.ts

Extend or override Tailwind utilities. Add custom plugins like Tailwind Typography or Forms here.

components/

Reusable components shared across pages (Navbar, Footer, UI primitives). Avoid duplicating logic elsewhere.

Deployment

Server infrastructure visualization

Recommended Hosting Options

Layero themes work with any modern hosting provider. Below are the three most common options — choose what fits your workflow and technical setup.

1. Deploy to Vercel

The easiest path. Push your repo to GitHub, import it in the Vercel dashboard and you are live in minutes. Every future push triggers an automatic redeploy.

npx vercel --prod

2. Deploy to Netlify

Connect your GitHub repository in the Netlify dashboard. Set build command to npm run build and publish directory to .next. Every push rebuilds automatically.

npx netlify deploy --prod
dns

3. Traditional Hosting (Apache / cPanel)

If your theme supports static export, you can host it on any standard Apache or cPanel server — no Node.js required. This is suitable for brochure sites and portfolios.

01

Enable static export

Check your theme's README to confirm static export is supported. In next.config.ts, output should be set to 'export'.

02

Build the static files

Run npm run build. Next.js generates an out/ folder containing plain HTML, CSS and JS — no server needed to serve them.

03

Upload via FTP

Use an FTP client (FileZilla, Cyberduck) or your hosting control panel's file manager to upload the contents of out/ to your public_html folder.

04

Go live

Your site is now live as a standard static website. No Node.js process, no server configuration required.

npm run build # generates the out/ folder

PRO TIP

Vercel and Netlify are the recommended choices for most users — zero configuration, automatic SSL and instant redeployment on every push. Use Apache hosting if you already have a shared hosting plan and want to minimise costs.

Edit Content

All user-facing content is split into focused TypeScript files inside the data/ folder at the project root. You should not need to touch individual page files for basic content changes.

FileWhat it controls
data/site.tsBusiness name, phone, email, address, hours, stats
data/services.tsServices / practice areas / menu items
data/team.tsTeam member profiles
data/testimonials.tsTestimonials (where applicable)
data/navigation.tsNav links

Refer to your theme's own README for the complete list of data files and their exact structure — it varies per theme.

data/site.tsTypeScript
export const siteConfig = { name: "Your Business", tagline: "Your memorable tagline", phone: "+1 (555) 000-0000", email: "hello@yourdomain.com", address: "123 Main St, City, Country", };

After saving the file, the dev server hot-reloads instantly. In production, a new build is required to apply changes.

How content updates work

The update process depends on where your site is hosted. Here is what to expect on each platform.

cloud

Vercel

  1. 01Edit the relevant files in your theme's data/ folder
  2. 02Commit and push to your repo
  3. 03Vercel rebuilds and redeploys automatically

Fastest workflow — changes are live in under a minute.

bolt

Netlify

  1. 01Edit the relevant files in your theme's data/ folder
  2. 02Commit and push to your repo
  3. 03Netlify rebuilds and redeploys automatically

Same as Vercel — push to deploy.

dns

Apache / Static

  1. 01Edit the relevant files in your theme's data/ folder locally
  2. 02Run npm run build to generate new static files
  3. 03Upload the new out/ folder via FTP

Requires access to source code and an FTP client each time.

WANT TO SKIP THE REBUILD?

Upgrade to the MAX plan and edit your content through a visual interface — no code, no terminal, no FTP required.

Replace Images

All placeholder images are loaded from external URLs. Replace them with your own assets in public/images/ or via your CMS media library.

01

Add your images

Drop files into public/images/. Accepted formats: WebP, AVIF, PNG, JPG. Aim for WebP at 80% quality for best performance.

02

Update the source path

In the relevant page or data file, replace the URL string with /images/your-file.webp. Next.js Image handles optimisation automatically.

03

Set width and height

If using the Next.js Image component, provide the intrinsic dimensions to prevent layout shift (CLS). Omit them if using fill mode.

IMAGE SIZES

Hero images: 1920×1080 px. Card thumbnails: 800×600 px. Avatars/logos: 400×400 px. Always export at 2× for retina displays.

CMS Ready

Layero themes ship with optional adapters for the three most popular headless CMS platforms. Connect the one that fits your workflow.

edit_square

Sanity

Real-time collaborative editing, GROQ query language, fully customisable Studio.

dns

Strapi

Self-hosted, open source. Full control over your data and deployment infrastructure.

api

Payload

Code-first, self-hosted Node.js CMS. TypeScript-native with auto-generated REST & GraphQL APIs.

lib/sanity.ts — example
import {createClient} from '@sanity/client'; export const sanity = createClient({ projectId: process.env.SANITY_PROJECT_ID!, dataset: 'production', apiVersion: '2024-01-01', useCdn: true, });

Stripe Ready

Commerce-enabled themes include a preconfigured Stripe integration. Add your keys and your checkout flow is live.

01

Create a Stripe account

Sign up at stripe.com and retrieve your Publishable Key and Secret Key from the Developers dashboard.

02

Add keys to .env.local

Set STRIPE_SECRET_KEY and NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY in your .env.local file.

03

Define your products

Create products and price IDs in the Stripe dashboard. Paste the price_xxx IDs into your products data file.

04

Test with Stripe CLI

Forward webhooks to your local server to test the checkout flow before going live.

WEBHOOK SECURITY

Always verify webhook signatures using stripe.webhooks.constructEvent(). Never trust webhook payload data without verification.

Upgrade Path

Already on START? You can upgrade to a higher tier at any time — just get in touch and we will apply a credit for what you have already paid.

rocket_launch

LVL-02

PRO Plan

€399

We handle deployment, domain setup and first launch. Hand it over to us and get a live website without touching the code.

  • checkTheme configuration
  • checkContent upload
  • checkDomain & hosting setup
  • checkLaunch-ready delivery
edit_note

LVL-03

MAX Plan

€999

Everything in PRO, plus a content management interface. Update pages, text and images yourself — no code, no rebuilds, no FTP.

  • checkEverything in Setup
  • checkCMS integration
  • checkVisual content editor
  • checkEdit without developer help
auto_awesome

LVL-MAX

ULTRA

Quote

Bespoke pages, third-party integrations and a tailored management solution built around your specific requirements.

  • checkCustom page design
  • checkAPI integrations
  • checkBespoke management
  • checkWhite-glove support

Ready to upgrade?

Tell us which plan you are on and which you want to move to. We will take it from there.

TALK TO US →

FAQ

Can I use a theme for multiple client projects?expand_more

A single license covers one site. For multiple client deployments, purchase an Agency License which allows unlimited production installs.

Is Layero compatible with React 19?expand_more

Yes. All themes target React 19 and Next.js 16 with the App Router. Server Components, Suspense, and Streaming are supported by default.

How do I update the theme colors?expand_more

Navigate to app/globals.css and modify the CSS custom properties inside the @theme block. Every color token cascades automatically to all components.

Can I integrate a custom API?expand_more

Absolutely. Create route handlers in app/api/ or use Server Components with fetch() for server-side data retrieval. The architecture is API-agnostic.

Still need help?

Our team is available for technical support and upgrade questions. Open a ticket and we will respond within 2 hours.

OPEN SUPPORT TICKET
help_center