syonad/syn

GnomeZworc f49eae6c31

The manifest covers components, pages, vendors and menu — config.yml
is a more accurate name. Updated build.sh (both project and template),
router.js comment, and README.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: GnomeZworc <nicolas.boufidjeline@g3e.fr>

2026-06-07 13:08:50 +02:00

1.9 KiB

Raw Blame History

Syn

Framework web minimaliste basé sur JavaScript vanilla et les Web Components. Routage hash-based, composants déclarés dans config.yml, build via build.sh.

Structure d'un projet

├── sources/               # Code servi — déployer ce dossier
│   ├── index.html
│   ├── favicon.svg
│   ├── config.json        # Config runtime (api_url, tokens…)
│   ├── core/              # Framework core
│   ├── components/        # Téléchargés par build.sh (gitignored)
│   ├── vendor/            # Libs tierces (gitignored)
│   └── pages/
│       └── <nom>/         # Une page = un dossier
├── config.yml         # Source de vérité
└── build.sh               # Télécharge les remotes + génère les JSON

Démarrer un projet

cp -r template/ mon-projet/
cd mon-projet/
./build.sh
python3 -m http.server 8000 --directory sources/

Ajouter une page

Créer sources/pages/<nom>/ avec :
- manifest.json — { "route", "label", "icon" }
- index.html — fragment HTML (ex. <ma-page></ma-page>)
- <nom>.js — customElements.define + export function init(main) {}
- <nom>.css — styles scopés à la page (optionnel)
Déclarer sous local_pages: dans config.yml
Ajouter la route à menu: si visible dans la nav
./build.sh

Ajouter un composant

Déclarer sous components: dans config.yml :

components:
  - name: mon-composant
    repo: https://git.example.com/org/mon-composant
    ref:  main

./build.sh — télécharge dans sources/components/mon-composant/

build.sh

./build.sh           # build complet
./build.sh --check   # valide le manifest sans télécharger

Dépendances : yq (mikefarah v4), jq, curl. Variable optionnelle : GIT_TOKEN pour les repos privés.

1.9 KiB Raw Blame History