Appearance
Start here: the first site, in twelve steps
The card: each step's tool or command, the rule that bites there with its code, and the page that says why. Read the pages when a step is yours.
The brief — every question at once, before
create_site; build on the yes: the stack (offer Astro), the currency, paid online or on the spot (ask, never assume), where enquiries go, the language, the design, the photographs, the icon. Bookings take their kind's kit whole; a shop,jtk add shop. → the brief, kits, the shopMake the site —
create_sitewith the slug, the name,locale,locales,bookings(a kit's kind),shop,blog,design; with bookings or a shop the brief'scurrency(asked, never guessed). The kit'sjtk createcommits contract 3, the quick template in Brumy's design (brumy.ch) —design: customis a stage; its words and people are placeholders — write the site in their language before they look.nextsays the first build; give a personget_preview_linknow. With a terminal:scaffold: false, thennpx @jtakeit/astro create <dir>(the same options), the dev server,open_dev_sessionand itsrun; give the developer the localhost. FillBRIEF.mdfrom the first answer. → connecting a site, working on a site locallyDeclare the blocks in
src/content/blocks.ts;npx @jtakeit/astro schemawritesjtk/schema.json, mints missingids and_keys —JTK_E_UNNAMED. A service hastakes; a price iscostsorrates; two rows on a minute are two prices —JTK_E_DIARY_NOT_READY. A date, an hour, a link is the owner's even unshown:no_tap_target,besideits field —JTK_W_OWNER_LOCKED. Entry types:form,ends_by(ended),JTK_W_DATE_HIDES. → the schema, modulesWrite the content — a page
jtk/pages/<path>.json,{id, path, name, seo, blocks}; an entryjtk/entries/<collection>/<slug>.json, its values underfields; the text on every pagejtk/shared.json. A value is its kind's: minutes for a time,{"minor": 4500}for money, an id for aref—JTK_E_DOCUMENT_INVALID. Another language is<name>.<locale>.jsonbeside the original,ofits id, only the words by_key— a price there isJTK_E_TRANSLATION_SHARED; what is booked is in every language;get_sitesays what is left to translate. → the files under jtk/, several languagesThe settings —
jtk/modules/bookings.jsonis{"v": 1, "settings": {…}}, each row with its_key. A business open past midnight writes the hours after it on the calendar day whose clock shows them. A service priced by the hour of the week covers every open hour, or the uncovered hour is not sold —JTK_W_UNPRICED_HOURS. → bookings on the siteJudge before the push —
validate_schemawith the schema, thejtk/files, translations too (jtk schema --judgefrom the tree), andsite_id: the settings, the entries and the currency in one answer. Act on advice — a service as a post, hours typed twice —JTK_W_MODULE_POST,JTK_W_MODULE_TWIN. → the contractAnnotate — every field a person taps carries
data-jtk-path, read off the built HTML, never the component:jtkit lint dist/on your build —JTK_E_UNANNOTATED_FIELD. An enquiry form's controls are the block'sasks—JTK_E_FORM_FIELD_UNDECLARED. → connecting a site · annotationsPush, then
commit_and_build— nothing public.get_sitesays where the code lives (code). First push: a GitHub remote in the copy → ask once (that repository, with our App a person installs, andattach_repo; or jtakeit); none →push_code, run its command, and say so.get_builduntil it settles, elseget_build_log. «That slug is taken» with no id is another account's site. → draft, saved, published, where the code livesRead what was built, and look at it —
get_built_pageis the HTML; withshot: "phone", the page as a visitor's phone draws it, in frames.Preflight —
preflightwithtry_booking(a shop:try_order) before saying done: the form says what it sends indata-sends, and a field the platform does not take is dropped from a stranger's booking —JTK_E_BOOKING_FIELD_UNKNOWN. → bookings on the site · the formHand over what is a person's — the launch, the channel the enquiries go to, the domain, another agent: the panel does those, and
preflightsays whose step each is. You cannot read the client's customers. → driving it from an agent, your client's dataLater — pull first (
git pull, orpull_codeandjtk pull); commit;push_codeorimport_branch;commit_and_build. Content not imported — a git push, or a document where you and the person's unsaved work changed one field (JTK_E_DRAFT_AHEAD, named inwaited) — waits in the branch until the next save or the editor's opening brings it in under the draft; after launch the words are the panel's, the shape and seed text the repository's.get_sitesays what the panel holds unsaved, and on a launched site a build is a candidate a person publishes. → working on a site locally
When a tool refuses, the code is the page: every error code.