@ofidj/generator-fidj 1.0.0 → 1.0.3

package/README.md

@@ -1,74 +1,153 @@
 # @ofidj/generator-fidj
 
-[![NPM version][npm-image]][npm-url]
-[![Build Status][travis-image]][travis-url]
+Generate a Fidj-integrated TypeScript app with a short command. Public identity and content are generator inputs; authentication and per-app privacy are reusable template behavior. Node 22 or 24 is the validation matrix.
 
-> build great mobile and web angular/ionic apps based on fidj.ovh authentication.
->
-> _Renamed from `generator-fidj` at 1.0.0. The old `generator-fidj@3.x` is deprecated. The yeoman command becomes `yo @ofidj/fidj` (note the `@ofidj/` prefix)._
+Registry examples require published compatible versions. For current workspace development, supply a built local SDK with `--sdk-path`.
 
-## Prerequisites
+## Content app — static hosting
 
-Look at mat's gist : https://gist.github.com/mlefree/2156f66dfb441f107bef157dde56a836
+```sh
+npx -y -p @ofidj/generator-fidj -p yo yo @ofidj/fidj my-app --app-id YOUR_FIDJ_ID --title "My App" --welcome "Welcome" --content "<p>About my app</p>" --domain example.com
+cd my-app
+npm install && npm run build-prod
+```
 
-## Installation
+Serve `www/` on a static host. It contains your public content, SDK sign-in/account creation, current roles, consent/history, scoped export and confirmed departure, plus `CNAME`. Private signing keys are never needed in the browser. `npm start` supplies an optional Node preview; this mode makes its API calls directly to Fidj.
 
-First, install [Yeoman](http://yeoman.io) and generator-fidj using [npm](https://www.npmjs.com/) (we assume you have pre-installed [node.js](https://nodejs.org/)) :
-```bash
-npm install -g yo
-npm install -g @ionic/cli
-npm install -g @angular/cli
-npm install -g @ofidj/generator-fidj
-```
-Then generate your new project:
-```bash
-yo @ofidj/fidj
-```
-or as an expert :
-```bash
-yo @ofidj/fidj my-app app2021 your-app-id "" me-as-user "my description" \
-   "Welcome there" \
-   "Hey<br>Heres my content: <img src=blank /><br> \o/ "
-```
+`--content` is trusted developer-authored HTML (like any checked-in application source), never untrusted visitor input. Set real terms before release; the generated agreement is explicitly a demo. The content app has no independent user database. Erasure/export cover Fidj-held membership records, and pending cleanup stays pending.
 
-## Development
+## Backend example — protected actions
 
-Make sure you've got yeoman installed :
-```bash
-npm install -g yo
-npm install -g @ionic/cli
-npm install -g @angular/cli
-```
+Omit `--content` to generate Studio Notes: a browser client plus Node backend with private persisted notes. The backend revalidates the session and live app roles for every protected request. Owner/Editor may write; other members may read their own notes. This mode requires Node hosting and is separate from the static content app scenario.
+
+Departure uses an in-app confirmation that states the membership, consent and notes being removed and preserves the membership when cancelled.
 
-Clone the repo, install it :
-```bash
-cd generator-fidj
-npm install
-npm link
+Configure the generated privacy adapter so departure from either Studio Notes or Fidj erases the same app data. Notes persist outside disposable output. Failed cleanup stays pending in Fidj and can be retried; completed receipts remain visible. See the generated README for server-side configuration and persistence limits.
+
+## CLI and local development
+
+The public entry is `yo @ofidj/fidj`; output goes to `<cwd>/<appname>`. Use the `npx` form above or install once:
+
+```sh
+npm install --no-save @ofidj/generator-fidj yo
+npx --no-install yo @ofidj/fidj my-app --app-id YOUR_FIDJ_ID
 ```
 
-And then use your local Fidj generator : 
-```bash
-mkdir your-app && cd your-app && \
-   yo @ofidj/fidj my-app app2021 your-app-id "" me-as-user "my description" \
-   "Welcome there" \
-   "Hey<br>Heres my content: <img src=blank /><br> \o/ " 
+Repeat a flag for `--highlight` and `--badge`; the values are read from the
+command line, so a comma inside one is safe. The old `app2021` positional command
+and its Ionic/Cordova templates are gone; the `typescript` template is the only
+one.
+
+> Maintainers: `bin/create-fidj.cjs` is the same scaffolder without Yeoman, for
+> tooling that runs from a checkout and cannot install `yo` —
+> `scripts/local-stack.py` and `fidj-app`'s `create:local` use it.
+> `test/parity.test.cjs` fails if either door ever gains an input the other
+> lacks. It is not an entry point to hand to anyone building an app.
+
+- `--anonymous true|false`: show or hide anonymous entry in content apps (default: `true`). Set `--anonymous false` for a sign-in-only entry flow, as mleweb does.
+- `--highlight "<heading>|<body>"`: add a numbered cell to the sign-in panel, repeatable up to six. These are the app's own selling points, so an app that passes none simply shows its identity — mleweb passes none, Fidj passes four.
+- `--badge <text>`: add a trust badge under the sign-in form, repeatable up to four, 40 characters each. None are supplied by default — "EU-hosted" or "GDPR art. 17 · 20" are claims about a particular app, not about every app the generator makes.
+- `--logo <image>` and `--favicon <image>`: the app's own marks, copied into `public/brand/`. The logo sits beside the app name at the top of the sign-in panel; the favicon goes in the browser tab. Both fall back to the Fidj mark, so neither is ever blank. Accepts `.png`, `.svg`, `.gif`, `.jpg`, `.webp` or `.ico` under 512KB — an animated GIF works as a logo, and as a favicon in the browsers that animate one.
+- `--api-endpoint`: select the API (default: hosted sandbox).
+- `--sdk-path` or `FIDJ_SDK_DIR`: use a built local SDK during coordinated development.
+- `--local` or `FIDJ_LOCAL=true`: use the loopback API/console. Test credentials stay in the validation guide, outside the content app UI. Supply the matching local app ID; `FIDJ_APP_ID` can override it.
+- `--replace`: regenerate only a destination containing `.fidj-generated`; unmarked projects are protected.
+
+The generated shell paints from one design system: `src/tokens.css` holds every
+colour, family and radius, and `src/style.css` may not introduce a literal of
+its own. Fonts are self-hosted under `public/fonts` and served from the build
+manifest, so a generated site stays statically hostable and makes no
+third-party request on sign-in. fidj-app consumes the same tokens, which is why
+a style change lands here first.
+
+Generation writes `.env.example`, `.env` and public `app.config.json`. Static configuration is embedded at build time: regenerate/rebuild when changing endpoints. Notes server configuration is read at runtime. Do not place secrets in any public configuration or content input.
+
+For unpublished coordinated changes, build the sibling SDK and pass `--sdk-path` with its absolute `dist` path. Committed templates use registry dependency `@ofidj/node ^3.6.24`; a registry-only install is not validated until coordinated versions are published.
+
+## Real validation repository
+
+[mleweb](https://github.com/mlefree/mleweb) is the thin command-line validation fixture whose generated website is mlefree.com. Its `package.json` passes the original Mario GIF, welcome text and About/CV/contact links directly into this generator. No custom downstream renderer is required. GitHub CI runs the same generation/build path on Node 22/24 and uploads artifacts. Publishing the site to gh-pages, which is what mlefree.com serves, is a separate deliberate job: it runs on mleweb's `master` or on an explicit workflow dispatch, never from a version branch.
+
+Run `npm test` for scaffolding/CLI safety tests. Generated projects include TypeScript checking and HTTP integration tests for live authorization and privacy isolation. See the [local acceptance walkthrough](../LOCAL-DEVELOPMENT.md). Follow TDD: add/run a failing generator or generated-app test before implementation, make it green, then refactor and rerun regression checks.
+
+
+## Releasing to npm
+
+Pushing to the `package` branch publishes the package, the same convention the
+SDK and contracts repositories use. CI installs, runs the tests and publishes
+with `NPM_TOKEN`; this package publishes from the repository root rather than
+from a `dist` directory, because it ships its sources.
+
+The package contains `bin/`, `lib/` and the `typescript` template only. The
+`app2018` and `app2021` Yeoman templates were deleted: nothing read them, and
+they accounted for 11.8MB of the repository. `main` points at
+`lib/scaffold.cjs`, so `require('@ofidj/generator-fidj')` returns `{ scaffold }`
+alongside the `create-fidj` binary.
+
+Publish contracts before the SDK, and the SDK before anything that resolves it
+from the registry: the SDK depends on `@ofidj/contracts` by range, so a build
+picks up whatever is published at the time.
 
-# look at the code : code .
-# or start it : npm start
+## Entry flow
+
+The generated content app opens on `/#/signin`. Sign in, or choose **Enter anonymously** when enabled, to open `/#/content`, containing the supplied HTML. Signed-in users can open **My privacy** separately. Sign-out and departure return to the sign-in screen. Anonymous content is public; this navigation flow is not a security boundary for static assets.
+
+## Compose an existing app as a module
+
+Build your application for the `/module/` base URL, then pass its public output to the same generator:
+
+```sh
+npx -y -p @ofidj/generator-fidj -p yo yo @ofidj/fidj my-app --app-id YOUR_FIDJ_ID --title "My App" --welcome "Welcome back" --description "Your app description" --anonymous false --module ./built-console --module-entry 'index.html#/my'
+cd my-app && npm install && npm run build-prod
 ```
 
-## License
+The result is one static website: the generated SDK sign-in entry and the module under `www/module/`. After login, the entry opens the module on the same origin. The module must use the same public app ID/API and independently validate authorization for its own operations. The generator copies public build assets without changing their source; module input cannot contain environment files, dependency directories or symlinks.
+
+Hash routes other than the generated entry/content/privacy views are forwarded to the module, preserving existing public cards and console links. The module remains responsible for guarding private routes.
+
+The module entry receives a `meta[name="fidj-signin"]` URL, relative to its base URL. A module can send its sign-in, logout or expired-session flow there. Fidj's console implements this handoff and preserves departure status. The generated preview serves module assets from an explicit build manifest, including directory index URLs.
+
+`fidj-app` now exercises this path with `npm run create:local`: its owner/profile/privacy features remain an explicit Angular console module, while the generator owns the shared entry and final assembly. The local launcher serves the generated Fidj output on port 4200. The source console is maintained outside disposable `.gen` and must be rebuilt before regenerating.
+
+## Generated account lifecycle
+
+Content and module entries include `#/forgot`, `#/reset`, `#/verify`, and authenticated `#/account` screens in the same split layout as sign-in. These routes remain in the generated shell when an application module is attached. Forgot-password responses are neutral; verification requires an explicit click. `My account` provides verification status and resend. Password reset affects the shared Fidj identity across apps. Configure the API’s trusted account UI URL for email links; the current generated API integration requires the coordinated 3.6.24 SDK/API. The server-backed Notes template remains a separate integration example.
+
+## App data adapter
+
+The Notes server exposes `POST /fidj/privacy` for HMAC-authenticated, timestamped export/erase operations. Set a private `FIDJ_PRIVACY_ADAPTER_KEY` and register the same app ID, endpoint and key in the API’s server-side `FIDJ_PRIVACY_ADAPTERS`. Static content apps need no independent data adapter. `FIDJ_DATA_DIR` must stay outside `www`, `dist` and disposable generated output; the generated environment defaults to a sibling data directory.
+
+The file adapter uses atomic writes and a serialized queue for one writer process. Replace it with a transactional database for multi-instance hosting. Erasure receipts retain a hashed subject for replay protection, pruned after 30 days on the next write. Backups and unregistered stores are not covered. Tests exercise live authorization, restart persistence, private exports, adapter authentication, failed cleanup and duplicate-request safety.
+
+
+### Check a registered data handler
+
+Generated starters include `npm run privacy:check`: configure the server-only `FIDJ_PRIVACY_ADAPTER_KEY` in `.env`, start the app, then run the command. It signs a readiness request, verifies capabilities and probes durable storage without exporting or deleting user records. `FIDJ_APP_URL` can override the default loopback URL. `npm run privacy:rehearse` builds and exercises an isolated temporary data store, including scoped export, failure, retry and persistence. Production app data and credentials are never inputs to that rehearsal.
+
+Readiness confirms this handler only. Register its trusted URL and independent secret with the Fidj API operator; the app owner console can then check the same connection. Group roles granted in Fidj are enforced by the generated backend on each protected operation.
+
+## Beta OIDC input
+
+`--oidc-issuer` selects the OIDC entry for content/module apps while preserving branding and anonymous-entry configuration. This is beta: the API ships an integrated provider from 3.6.26, but it serves no `/oidc` routes until an operator configures an issuer and signing keys, so confirm the issuer you pass actually answers discovery before offering it.
+
+A compatible issuer, REST API and registered callback without a fragment are prerequisites. Validate that integration and coordinated SDK publication before offering it to app builders. Notes retains its existing authentication flow; no subject migration is implied.
+
+## Required service agreement
+
+All generated sign-in and account-creation forms (content, composed Fidj and
+Notes) share an unchecked required agreement checkbox. Both submit buttons stay
+disabled until it is checked. Reading the agreement opens an in-app dialog;
+failed agreement loading keeps sign-in blocked. Anonymous entry, when enabled,
+is not a login and does not record agreement acceptance.
 
-MIT 2021 © [fidj.ovh](fidj.ovh)
+The text and version come from the app's public API metadata, not copied generator
+settings. The API records acceptance before issuing the app token, preserves
+optional choices, and rejects a missing choice or stale version. Repeated login
+with the same version does not duplicate the history. Administrative membership
+creation does not fabricate a user's acceptance.
 
-[npm-image]: https://badge.fury.io/js/@ofidj%2Fgenerator-fidj.svg
-[npm-url]: https://npmjs.org/package/@ofidj/generator-fidj
-[travis-image]: https://travis-ci.org/ofidj/generator-fidj.svg?branch=master
-[travis-url]: https://travis-ci.org/ofidj/generator-fidj
-[daviddm-image]: https://david-dm.org/ofidj/generator-fidj.svg?theme=shields.io
-[daviddm-url]: https://david-dm.org/ofidj/generator-fidj
-[coveralls-image]: https://coveralls.io/repos/ofidj/generator-fidj/badge.svg
-[coveralls-url]: https://coveralls.io/r/ofidj/generator-fidj
-[codecov-image]: https://codecov.io/gh/ofidj/generator-fidj/branch/master/graph/badge.svg
-[codecov-url]: https://codecov.io/gh/ofidj/generator-fidj
+Before release, the owner sets `configurationAsJSON.serviceAgreement` to
+`{"version":"2026-09-11","text":"Your complete app service agreement"}` through
+`PUT /apps/:appId`, preserving its other configuration fields. Changing the text
+requires a new version. Until configured, the API exposes the explicitly labelled
+`starter-demo-1` demo agreement. No generated-source edit is necessary.

package/bin/create-fidj.cjs

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+const { parseArgs } = require("node:util");
+const { scaffold } = require("../lib/scaffold.cjs");
+try {
+  const { values, positionals } = parseArgs({
+    allowPositionals: true,
+    options: {
+      "app-id": { type: "string" },
+      "api-endpoint": { type: "string" },
+      "oidc-issuer": { type: "string" },
+      "sdk-path": { type: "string" },
+      title: { type: "string" },
+      welcome: { type: "string" },
+      description: { type: "string" },
+      content: { type: "string" },
+      highlight: { type: "string", multiple: true },
+      badge: { type: "string", multiple: true },
+      logo: { type: "string" },
+      favicon: { type: "string" },
+      anonymous: { type: "string" },
+      domain: { type: "string" },
+      module: { type: "string" },
+      "module-entry": { type: "string" },
+      local: { type: "boolean" },
+      replace: { type: "boolean" },
+      help: { type: "boolean" },
+    },
+  });
+  if (values.help || positionals.length !== 1) {
+    console.log(
+      "Usage: create-fidj <directory> --app-id <fidjId> [--api-endpoint <url>] [--title <text> --welcome <text> --description <text> --content <html> --domain <hostname>] [--highlight '<heading>|<body>' ...] [--badge <text> ...] [--logo <image>] [--favicon <image>] [--module <built-directory> --module-entry <index.html#/route>] [--oidc-issuer https://api.example/oidc] [--anonymous true|false] [--local] [--replace]",
+    );
+    process.exitCode = values.help ? 0 : 1;
+  } else {
+    const dir = scaffold(positionals[0], {
+      appId: process.env.FIDJ_APP_ID || values["app-id"],
+      apiEndpoint: values["api-endpoint"],
+      oidcIssuer: values["oidc-issuer"],
+      sdkPath: values["sdk-path"] || process.env.FIDJ_SDK_DIR,
+      title: values.title,
+      welcome: values.welcome,
+      description: values.description,
+      content: values.content,
+      highlights: values.highlight,
+      badges: values.badge,
+      logo: values.logo,
+      favicon: values.favicon,
+      anonymous: values.anonymous,
+      domain: values.domain,
+      module: values.module,
+      moduleEntry: values["module-entry"],
+      local: values.local || process.env.FIDJ_LOCAL === "true",
+      replace: values.replace,
+    });
+    console.log(
+      `Created ${dir}\nNext: copy .env.example to .env, then npm install && npm run build && npm start.`,
+    );
+  }
+} catch (error) {
+  console.error(error.message);
+  process.exitCode = 1;
+}

package/generators/app/index.js

@@ -1,200 +1,111 @@
-const Generator = require('yeoman-generator');
-const yosay = require('yosay');
-const chalk = require('chalk');
+const Generator = require("yeoman-generator");
+const { scaffold } = require("../../lib/scaffold.cjs");
+
+// Yeoman and bin/create-fidj.cjs are two doors into the same scaffolder, and
+// they must stay at parity: an input added to one and not the other silently
+// disappears for half the users. test/parity.test.cjs fails when they drift.
+const TEXT_OPTIONS = [
+  "app-id",
+  "api-endpoint",
+  "oidc-issuer",
+  "sdk-path",
+  "title",
+  "welcome",
+  "description",
+  "content",
+  "anonymous",
+  "domain",
+  "module",
+  "module-entry",
+  "logo",
+  "favicon",
+];
+// Repeatable: --highlight twice yields two cells.
+const LIST_OPTIONS = ["highlight", "badge"];
+const FLAG_OPTIONS = ["local", "replace"];
+
+// Yeoman joins a repeated flag into one comma-separated string before any type
+// coercion, and splitting that back is wrong: a highlight body legitimately
+// contains commas ("An install, a fidjId, a few lines"). Read the occurrences
+// from argv, which is exactly what was typed, and fall back to Yeoman's value
+// when the generator is composed programmatically rather than from a command
+// line.
+function repeated(name, fallback, argv = process.argv) {
+  const found = [];
+  for (let index = 0; index < argv.length; index += 1) {
+    if (argv[index] === "--" + name && index + 1 < argv.length)
+      found.push(argv[index + 1]);
+    else if (argv[index].startsWith("--" + name + "="))
+      found.push(argv[index].slice(name.length + 3));
+  }
+  if (found.length) return found;
+  if (fallback === undefined) return undefined;
+  return Array.isArray(fallback) ? fallback : [fallback];
+}
 
 module.exports = class extends Generator {
   constructor(args, opts) {
     super(args, opts);
-
-    this.hasBeenRecordedInFidjOvh = true;
-    this.templateName = 'app2021'; //'app2021'; //'app2018' ''ionic2020'
-
-    this.option('skip-welcome-message', {
-      desc: 'Skips the welcome message',
-      type: Boolean
+    this.argument("appname", { type: String, required: false });
+    for (const key of TEXT_OPTIONS) this.option(key, { type: String });
+    for (const key of LIST_OPTIONS) this.option(key, { type: String });
+    for (const key of FLAG_OPTIONS) this.option(key, { type: Boolean });
+    this.option("api-endpoint", {
+      type: String,
+      default: "https://api.sandbox.fidj.ovh/v3",
     });
-
-    this.argument('appname', {type: String, required: false, desc: 'Your app name'});
-    this.argument('appType', {type: String, required: false, desc: 'For ex: "app2021" '});
-    this.argument('appId', {type: String, required: false});
-    this.argument('appOptions', {type: String, required: false});
-    this.argument('appUserName', {type: String, required: false});
-    this.argument('appDescription', {type: String, required: false});
-    this.argument('appWelcome', {type: String, required: false});
-    this.argument('appContent', {type: String, required: false});
   }
-
-  async initializing() {
-    this.pkg = require('../../package.json');
-  }
-
   async prompting() {
-    if (!this.options['skip-welcome-message'] && !this.options.appId) {
-      this.log(yosay('\'Allo \'Welcome to ' + chalk.red('fidj.ovh') + ' generator'));
-
-      const promptConditions = [{
-        type: 'confirm',
-        name: 'hasBeenRecordedInFidjOvh',
-        message: 'Did you recorded your app in fidj.ovh and received your appId ?',
-        default: false
-      }];
-
-      const conditions = await this.prompt(promptConditions);
-      this.hasBeenRecordedInFidjOvh = !!conditions.hasBeenRecordedInFidjOvh;
-      if (!this.hasBeenRecordedInFidjOvh) {
-        const err = 'You need to submit your app on https://fidj.ovh first. ' +
-          'It will help you to build a valid app name and give you a appId.';
-        this.log(yosay('Sorry : ' + chalk.red(err) + ' See you in 2 minutes ?'));
-      }
-    }
-
-    if (!this.options.appname || !this.options.appUserName || !this.options.appDescription) {
-      const prompts = [
-        {
-          type: 'input',
-          name: 'appUserName',
-          message: 'Your (github) user name'
-        },
-        {
-          type: 'input',
-          name: 'appName',
-          message: 'Your app name (as shown on device)',
-          default: this.appname.replace(/[^\w\s]/gi, '').replace(/\s/g, '_').replace(/\s+/g, '').replace(/[\. ,:-]+/g, '').toLowerCase()
-        },
-        {
-          type: 'input',
-          name: 'appDescription',
-          message: 'App description',
-          default: this.appname
-        }
-      ];
-
-      this.props = await this.prompt(prompts);
-    } else {
-      this.props = {
-        appName: this.options.appname,
-        appUserName: this.options.appUserName,
-        appDescription: this.options.appDescription,
-        appWelcome: this.options.appWelcome || '<h1>Welcome</h1>',
-        appContent: this.options.appContent || '<h1>Hello</h1>'
-      };
-    }
-
-    const pack = this.props.appUserName.replace(/[^\w\s]/gi, '').replace(/\s+/g, '').replace(/[\. ,:-]+/g, '').toLowerCase();
-    const age = this.props.appName.replace(/[^\w\s]/gi, '').replace(/\s/g, '_').replace(/\s+/g, '').replace(/[\. ,:-]+/g, '').toLowerCase();
-    const packageDefault = 'ovh.' + (pack ? pack : 'fidj') + '.' + age;
-
-    if (!this.options.appId) {
-      const prompts02 = [{
-        type: 'input',
-        name: 'appId',
-        message: 'Your app Id'
-      },
-        {
-          type: 'input',
-          name: 'appPackage',
-          message: 'Your app package name',
-          default: packageDefault
-        },
-        {
-          type: 'input',
-          name: 'appHomepage',
-          message: 'Home page url',
-          default: 'https://fidj.ovh/_/' + age
-        }
-      ];
-
-      this.props02 = await this.prompt(prompts02);
-    } else {
-      this.props02 = {
-        appId: this.options.appId,
-        appPackage: packageDefault,
-        appHomepage: 'https://fidj.ovh/_/' + age
-      };
-    }
+    this.answers = await this.prompt([
+      ...(!this.options.appname
+        ? [
+            {
+              type: "input",
+              name: "name",
+              message: "Project name",
+              default: "my-fidj-app",
+            },
+          ]
+        : []),
+      ...(!this.options["app-id"]
+        ? [
+            {
+              type: "input",
+              name: "appId",
+              message: "Public fidjId from your owner console",
+            },
+          ]
+        : []),
+    ]);
   }
-
-  async writing() {
-    if (!this.hasBeenRecordedInFidjOvh) {
-      return;
-    }
-
-    let copyAll = true;
-    if (this.options.appType === 'app2018') {
-      this.templateName = 'app2018';
-    } else {
-      this.templateName = 'app2021';
-    }
-
-    const now = new Date();
-    const version = '' + ('' + now.getFullYear()).substr(2) + '.' + (now.getMonth() + 1) + '.' + now.getDate();
-
-    const appArguments = {
-      appName: this.props.appName,
-      appNameStrict: this.props.appName.replace(/[^\w\s]/gi, '').replace(/\s+/g, '').replace(/[\. ,:-]+/g, '').toLowerCase(),
-      appDescription: this.props.appDescription,
-      appWelcome: this.props.appWelcome,
-      appContent: this.props.appContent,
-      appUserName: this.props.appUserName,
-      appHomepage: this.props02.appHomepage,
-      appPackage: this.props02.appPackage,
-      appId: this.props02.appId,
-      appOptions: this.options.appOptions ? ', {' + this.options.appOptions + '}' : '',
-      appVersion: version,
-      appKeywords: 'fidj',
-      appYear: now.getFullYear(),
-      appColor: 'white'
-    };
-
-    this.fs.copyTpl(
-      this.templatePath(this.templateName + '/*'),
-      this.destinationPath(),
-      appArguments
-    );
-
-    this.fs.copyTpl(
-      this.templatePath(this.templateName + '/.*'),
-      this.destinationPath(),
-      appArguments
-    );
-
-    this.fs.copyTpl(
-      this.templatePath(this.templateName + '/src'),
-      this.destinationPath('src'),
-      appArguments
+  writing() {
+    const name = this.options.appname || this.answers.name;
+    scaffold(this.destinationPath(name), {
+      name,
+      title: this.options.title,
+      welcome: this.options.welcome,
+      description: this.options.description,
+      content: this.options.content,
+      anonymous: this.options.anonymous,
+      highlights: repeated("highlight", this.options.highlight),
+      badges: repeated("badge", this.options.badge),
+      logo: this.options.logo,
+      favicon: this.options.favicon,
+      module: this.options.module,
+      moduleEntry: this.options["module-entry"],
+      domain: this.options.domain,
+      sdkPath: this.options["sdk-path"] || process.env.FIDJ_SDK_DIR,
+      oidcIssuer: this.options["oidc-issuer"],
+      local: this.options.local || process.env.FIDJ_LOCAL === "true",
+      replace: this.options.replace,
+      appId:
+        process.env.FIDJ_APP_ID || this.options["app-id"] || this.answers.appId,
+      apiEndpoint: this.options["api-endpoint"],
+    });
+    this.log(
+      `Created ${name}. Copy .env.example to .env, then npm install && npm run build && npm start.`,
     );
-
-    if (copyAll) {
-      this.fs.copy(
-        this.templatePath(this.templateName + '/platforms'),
-        this.destinationPath('platforms')
-      );
-
-      this.fs.copy(
-        this.templatePath(this.templateName + '/resources'),
-        this.destinationPath('resources')
-      );
-
-      this.fs.copy(
-        this.templatePath(this.templateName + '/tests'),
-        this.destinationPath('tests')
-      );
-
-      //this.fs.copy(
-      //  this.templatePath(this.templateName + '/www'),
-      //  this.destinationPath('www')
-      //);
-    }
-  }
-
-  async install() {
-    if (!this.hasBeenRecordedInFidjOvh) {
-      return;
-    }
-    this.npmInstall();
-  }
-
-  async end() {
-
   }
 };
+
+module.exports.repeatedOption = repeated;