Documentation

Build your site by hand.

This page covers everyday use: you open the admin panel, build your pages, organise your menu. Not a line of code, not a single API call. Running the site through an agent is described separately, and stays optional — everything below works without it.

Install JEIKOAPI and AI-driven management

Before you build anything

Three settings shape the look of every page to come. Set them first, and you will not have to rework each page afterwards.

Identity

Settings ▸ Site identity. Name, logo, tab icon, contact details and type of business. This information also feeds the structured data that search engines read: you never enter it twice.

Colours

Ten theme colours, including accent, background, text and muted text. Every page refers to them by variable rather than by value: change the accent here and it changes everywhere, buttons and links included.

Fonts

Eleven roles — headings, body, links, buttons, menu — set separately on desktop, tablet and mobile. Always set a role and its hover state together: a different hover size makes the button jump under the cursor.

Anatomy of a page

A page is a stack with four levels. It is the only concept you need: everything else follows from it, and the editor never offers to create an element without its parent.

Page
└─ Section a horizontal band: its background, its margins
└─ Row a row, split into 1 to 12 columns
└─ Block a cell in a column
└─ Content text, image, button, form, calendar…

The section carries the background and the vertical space. The row carries the column layout. The block is the cell, and the content is what you put in it. A section with no row is perfectly valid: it gives the page room to breathe.

Columns are counted out of twelve

A three-column row is laid out as 4-4-4, two unequal columns as 8-4. The total is twelve. Above all: you need as many segments as blocks — three blocks on a one-segment layout end up squashed.

Four devices, always

Phone up to 767 px, tablet up to 991 px, laptop up to 1199 px, desktop beyond. Every setting exists for all four. Three columns on desktop happily become one on a phone: 12-12-12.

Building a page, step by step

The routine is always the same, whatever the page.

  1. Create the page. Pages ▸ New page. It starts as a draft: nobody sees it until you publish it.
  2. Give it an address. The “tag” becomes the path in the URL. A page filed in a category inherits that category's path, if you show the category in the address.
  3. Fill in the metadata. The title and description that will appear in search results. Without a description, the search engine cuts a fragment out of the page body — rarely the right one.
  4. Add a section, give it a background and top and bottom spacing. That vertical space is what lets the page breathe; it is set per device, and shrinks on phones.
  5. Add a row, choose its number of columns and their layout — on every device.
  6. Place the blocks and their content. Two blocks in the same column stack vertically; in two different columns, they sit side by side.
  7. Publish. It is a separate step from saving, on purpose.

Check the page on a phone before publishing. A site that looks right only on its designer's screen is a broken site for most of its visitors — and the editor lets you switch from one device to another without saving anything.

Organising pages, and guiding visitors to them

Two separate mechanisms that are often confused: categories organise pages among themselves, the menu guides the visitor. One does not imply the other — a page can live in a category without appearing in the menu, which is the usual case once a site grows past a dozen pages.

Categories and subcategories

They give you a working tree, and optionally a path in the address. Show the category in the URL and the page lands at /category/subcategory/page/ — which is what this site does: this page is filed under “documentation”.

Menus

A main menu and a footer menu, each an ordered list of entries pointing to pages or free addresses. The menu has its own style, independent of the site fonts; that is where you set its font, not in the general settings.

The modules

Each one is managed from its own tab and placed in a page as a block. They are independent: a showcase site does not switch on the store or the courses, and never sees them.

Online store

Products, variants, stock, VAT, shipping, orders. Structured data for product pages is generated automatically.

Appointments

Appointment types, availability, time slots, automatic reminders. The calendar goes into any page as a block.

Questionnaires

Scored tests, profiles and combinations of criteria. The result can trigger an email, a redirect or access to content.

Online courses

Learning paths, modules, progress, quizzes and certificates. Access is granted on enrolment or after payment.

Emails

Sixty-seven events, each with its own editable template. Mandatory emails cannot be switched off.

Page editor

Twenty-four content types, including fourteen dynamic blocks: FAQ, tabs, carousel, pricing table, countdown.

Looking after the site

What runs without you, and the one step that stays manual.

Updating

Settings ▸ Update JEIKO. A badge appears when a newer version is released, and the page tells you which one. The update verifies the package checksum, backs up the database, applies migrations and restarts the service. It is the only manual step.

The cache

The site caches the site object, page bodies and rendered menus. There is nothing to configure: every saved change purges exactly what it needs to. A purge button still exists in the settings, for when you want to be sure.

Performance

Images are generated in six sizes on upload and served through srcset, stylesheets are minified on publication, costly template fragments are cached. A PageSpeed audit runs from the admin panel and keeps its history.

Backups

The database is backed up before every update. Beyond that, backups are your hosting's job: JEIKO runs on your server, with your data — that is the whole point, and it leaves that responsibility with you.

Guides and references

Step by step, from the first setting to the richest module.

Tutorial

From installation to the first live page, in seven steps.

Manual configuration

The Settings menu and every variable of the .env file.

Sections, rows, blocks

How a page is built, and the twenty-three blocks.

Questionnaire guide

Profiles, combinations, dimensions mode, simulation.

Course guide

Outline, videos, quizzes, paid or granted access.

Appointment guide

Types, slots, payment, waiting list.

Customising emails

Subject, body, variables, preview, default version.

Installation

The commands to install, update and remove a site.

Connect Claude

Hand the building and upkeep of the site to Claude.

Shop guide

Products, subscriptions, discount codes, invoices, Google Shopping.

Connect the services

Email, Stripe, Google Merchant, PageSpeed, Google Calendar, social login, licence.

Newsletter guide

Lists, proof of consent, scheduled sending, tracking, CRM.

Handing all of this to an agent

Everything above can also be done by a program. You then create an agent: a named mandate, with its roles, its expiry date and its call limit. That mandate — and nothing else — is what you give to an assistant. The agent never touches the database, and goes through the same checks you do in the interface.

Creating one takes a minute, from Settings ▸ AI agents:

  1. Name the agent after its purpose — “blog writing”, “catalogue import”. The name shows up in the log; an agent called “test” tells nothing to whoever reads the traces six months later.
  2. Tick only the roles it strictly needs. There are eight, one per area. An agent that writes pages has no business reading booked appointments.
  3. Set an expiry date. A key with no expiry is a key you will forget to revoke.
  4. Adjust the hourly limit if the default rate does not suit — a catalogue migration needs more than a one-off correction.
  5. Copy the key. It is shown only once: only its fingerprint is stored. Lost, it can be replaced; it cannot be recovered.

The assistant then needs no documentation from you: the API's manual is served by the API itself, generated from the code.

API and AI-driven managementWhat it makes possible

With Claude, on desktop or phone

The simplest route is the connector: Claude plugs into your site from claude.ai, the mobile app or Claude Code, with no key to copy. The step-by-step guide takes three steps.

Connect Claude to your site