Startpaketet

Klona templates/starter-smb, peka den mot en publicerad hemsida i Snabbsite och lämna över en redigerare som kunden inte kan ha sönder.

Startpaketet är en liten Next.js-hemsida som ritar upp en Snabbsite-hemsida med din egen kod. Du klonar den, lägger upp den hos din egen leverantör, och kunden fortsätter ändra text och bilder i Snabbsite. När kunden publicerar byggs din version om.

Här börjar du en ny hemsida i kod. Ska du i stället flytta in en befintlig hemsida, läs Konvertera med en agent.

Var den ligger

Mallen heter templates/starter-smb och ligger i SDK-repot, inte här. Det finns ingen kopia att ladda ner på den här sidan.

Källkod: github.com/HH-Studio/Sajtbuilder-SDK
Sökväg i repot: templates/starter-smb

git clone https://github.com/HH-Studio/Sajtbuilder-SDK.git
cp -R Sajtbuilder-SDK/templates/starter-smb ./min-kunds-hemsida
cd ./min-kunds-hemsida
npm install
npm run dev

@snabbsajt/site-kit och @snabbsajt/cli ligger inte på npm än. npm install ovan hittar dem bara när du installerar inifrån SDK-repot. Tills paketen är publicerade är mallen kod du läser och anpassar, inte ett beroende du installerar.

Miljövariablerna den läser

Utan dessa ritar mallen upp sin egen src/site.ts i stället, så npm run dev fungerar innan du har en hemsida att peka mot. Den reservversionen ser trovärdig ut, och just därför är det första du kontrollerar efter en driftsättning att du ser kundens riktiga innehåll och inte den.

Variabel	Krävs	Vad det är
`SNABBSAJT_API_URL`	Ja, i skarp drift	Adressen till leveransen, `https://<deployment>.convex.site`. Du får värdet av Snabbsite.
`SNABBSAJT_SITE_ID`	Ja, i skarp drift	Id:t för hemsidan vars publicerade version du ritar upp.
`SNABBSAJT_DELIVERY_TOKEN`	Ja, i skarp drift	En nyckel som bara får läsa den hemsidan. Börjar med `sajt_pub_`. Visas en gång.
`SNABBSAJT_DELIVERY_TOKEN` (testversion)	Valfritt	En egen nyckel som börjar med `sajt_draft_`, satt bara i din testmiljö. Den läser utkastet, så testversionen visar sådant ingen har publicerat.

Alla ligger på servern. Lägg aldrig en nyckel bakom ett NEXT_PUBLIC_-namn och skicka den aldrig med i webbläsaren. Du skapar och spärrar nycklar under Inställningar → Utvecklare → Nycklar för er app.

Översättningen från publicerad version till komponenter är renderModelFromPublished och renderModelFromPackage i @snabbsajt/site-kit, så din egen app kan använda den utan mallen. Mer om det: Leverans till egen kod.

Bygg om när kunden publicerar

Skapa en deploy-krok hos din leverantör och klistra in den under Inställningar → Utvecklare → Var hemsidan visas. Snabbsite anropar den efter en lyckad publicering, så kunden trycker Publicera och din version byggs om av sig själv.

En andra krok under Bygg om testversionen gör samma sak för utkastet. Den är kraftigt bromsad, så många tangenttryck blir en enda ombyggnad.

Vad kunden får ändra

Kunden ändrar innehåll, aldrig kod. Kunden kan ändra:

text i varje fält du markerat som redigerbart, rubriker och knappar också;
bilder, och den alt-text som hör till;
kontaktuppgifter, öppettider och tjänster;
ordningen på blocken på en sida, och vilka sidor som finns;
när det går live, med Publicera.

Kunden kan inte ändra dina komponenter, din formgivning, dina sidadresser eller något som skulle få bygget att gå sönder. Om kunden ändrar en rubrik och du senare skickar in en ny version behålls kundens rubrik, och du får veta det som en krock i stället för att den skrivs över.

Innan du lämnar över

Lägg upp mallen med de tre variablerna satta och kontrollera att sidan visar kundens publicerade innehåll, inte reservversionen i src/site.ts.
Klistra in deploy-kroken och publicera en gång från redigeraren. Kontrollera att ombyggnaden startar utan att någon rör din leverantör.
Bjud in kunden och bestäm vad kunden får använda: Lämna över till kunden.

Hittade du inte svaret, eller stämmer något inte? Berätta det för oss.