Du zip à la mise en ligne

Démarrer en 5 minutes

Il vous faut Node 22 ou plus récent, et pnpm (npm i -g pnpm). Ensuite, dans le dossier décompressé :

pnpm install
pnpm dev        # http://localhost:4321
pnpm build      # build de production dans dist/
pnpm check      # vérifie tous les types

Vos contenus vivent dans des fichiers en clair : l'identité du site dans src/config/siteData.json.ts, la navigation dans navData.json.ts, les tarifs, la FAQ et les mentions juste à côté. Les articles de blog sont des fichiers markdown dans src/data/blog/.

allowBuilds:
  esbuild: true
  sharp: true

Où se trouve quoi

src/
  config/       vos contenus : identité, navigation, tarifs, FAQ, mentions
  data/         articles, auteurs, intégrations (markdown + json)
  components/
    Sections/   les blocs de page que vous réagencez
    ui/         43 primitives (boutons, dialogues, tableaux...)
    islands/    les 3 îlots React
    three/      l'océan WebGL
  pages/        un fichier par route
  styles/       tokens.css = tout le design system
scripts/        rebrand.mjs, og.mjs
wiki/           comment tout s'emboîte, pour les humains et les agents

Rebrander en une commande

Donnez au thème la couleur de votre marque et toute la palette se régénère : les composants, le thème sombre, et même les images sociales générées suivent.

pnpm rebrand "#7a59ff"          # votre couleur d'accent
pnpm rebrand "#7a59ff" --dark "#140a2e"
pnpm rebrand --restore           # retour à la palette Aloha d'origine
pnpm og                          # régénère les images OG assorties

Publier gratuitement

Le build ne produit que des fichiers statiques : l'offre gratuite de n'importe quel hébergeur moderne le porte. Cloudflare : créez un projet, pointez-le sur votre dépôt, commande de build pnpm build, dossier de sortie dist. Netlify et Vercel : les deux mêmes valeurs. Renseignez site dans astro.config.mjs avec votre vrai domaine, pour que les URLs canoniques, le sitemap et les liens OG soient justes.

En faire une application native

Aloha n'a ni serveur ni CDN externe, ce qui est exactement ce que Capacitor sait emballer. Le thème gère déjà les zones sûres des iPhone à encoche.

pnpm build
pnpm add -D @capacitor/core @capacitor/cli
npx cap init "Votre app" com.example.app --web-dir=dist
npx cap add ios && npx cap open ios

Après chaque changement de contenu : pnpm build && npx cap sync.

Travailler avec un agent IA

Ouvrez le dossier dans n'importe quel agent de code qui lit AGENTS.md, le mode d'emploi du dépôt. Il renvoie à docs/conventions/, cinq fichiers de conventions (astro, tailwind, typescript, motion, seo) ancrés sur de vrais fichiers, à docs/design.md, la doctrine de design de la maison, ce qu'elle refuse et ce qu'elle fait à la place, et à wiki/, l'architecture citée en chemin:ligne. Demandez une nouvelle section et l'agent la construit dans le design system au lieu d'inventer le sien.

Mises à jour et support

Chaque version jusqu'à la prochaine version majeure est incluse dans votre licence : vous recevez un email avec un lien de téléchargement frais, et la page des nouveautés raconte ce qui a changé, en français clair. Le support se fait par email, à contact@alohapixel.com, et c'est celui qui a écrit le code qui répond.