> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# base44 scaffold

> Génère un projet local pour une application Base44 existante. Utilisez-la lorsque vous avez déjà une application Base44 (vous connaissez son ID d'application) et voulez configurer les fichiers locaux pour l'utiliser. S'exécute entièrement en mode non interactif, elle est donc sûre pour les agents et la CI...

<Warning>
  Cette page fait partie d'une compétence d'agent de code IA et est écrite pour les agents, pas pour les humains. Pour la documentation Base44 lisible par un humain, consultez la [documentation développeur](/developers).
</Warning>

# base44 scaffold

Génère un projet local pour une application Base44 **existante**. Utilisez-la lorsque vous avez déjà une application Base44 (vous connaissez son ID d'application) et voulez configurer les fichiers locaux pour l'utiliser. S'exécute entièrement en mode non interactif, elle est donc sûre pour les agents et la CI.

## Critique : quand utiliser Scaffold vs Create vs Link

| Scénario                                                                                    | Commande              |
| ------------------------------------------------------------------------------------------- | --------------------- |
| Démarrage à zéro, souhaite une NOUVELLE application Base44 + un projet à partir d'un modèle | `npx base44 create`   |
| Vous avez déjà une application Base44 (par ID) et voulez des fichiers locaux                | `npx base44 scaffold` |
| A un `base44/config.jsonc` local mais pas de `.app.jsonc`                                   | `npx base44 link`     |

## Syntaxe

```bash theme={null}
npx base44 scaffold [name] [options]
```

Génère dans le **répertoire courant**.

## Arguments et options

| Argument/Option | Description                                                                                  | Requis |
| --------------- | -------------------------------------------------------------------------------------------- | ------ |
| `name`          | Nom du projet (positionnel). Par défaut, le nom du répertoire courant.                       | Non    |
| `--app-id <id>` | ID d'application Base44 existant. Se replie sur la variable d'environnement `BASE44_APP_ID`. | Oui\*  |
| `--no-skills`   | Ignorer l'installation des compétences d'agent IA (installées par défaut)                    | Non    |

\*L'ID d'application est requis : fournissez-le via `--app-id` ou la variable d'environnement `BASE44_APP_ID`. Si aucun n'est défini, la commande échoue.

## Exemples

```bash theme={null}
# Scaffold the current directory for an existing app
npx base44 scaffold --app-id app_123

# Scaffold the current directory with an explicit project name
npx base44 scaffold my-app --app-id app_123

# Provide the app ID via environment variable instead of the flag
BASE44_APP_ID=app_123 npx base44 scaffold

# Scaffold without installing AI agent skills
npx base44 scaffold --app-id app_123 --no-skills
```

## Ce que fait la commande

1. Résout l'ID d'application depuis `--app-id` ou la variable d'environnement `BASE44_APP_ID`
2. Applique le modèle `backend-only` au répertoire courant
3. Enregistre les fichiers du projet contre l'application existante et écrit `base44/.app.jsonc` avec l'ID d'application
4. Installe les compétences d'agent IA (sauf si `--no-skills` est passé)

## Reprise après provisionnement (Stripe Projects / projects.dev)

`scaffold` est la commande à exécuter après le provisionnement d'une application Base44 via un flux Stripe Projects / projects.dev. **Utilisez `scaffold`, pas `create`** — l'application existe déjà, `create` créerait donc un doublon.

Lorsque Base44 est provisionné ainsi, les identifiants sont injectés dans l'environnement sous un préfixe `BASE44_PROJECTS_` (par exemple `BASE44_PROJECTS_BASE44_APP_ID`, `BASE44_PROJECTS_BASE44_ACCESS_TOKEN`, `BASE44_PROJECTS_BASE44_REFRESH_TOKEN`). Le CLI les normalise automatiquement en noms nus (`BASE44_APP_ID`, `BASE44_ACCESS_TOKEN`, …). En conséquence :

* L'**ID d'application** est résolu automatiquement depuis `BASE44_APP_ID` — pas besoin du flag `--app-id`.
* L'**authentification** est initialisée depuis `BASE44_ACCESS_TOKEN` / `BASE44_REFRESH_TOKEN` — pas besoin de `npx base44 login` interactif.

Toute l'étape post-provisionnement se résume donc à :

```bash theme={null}
npx base44 scaffold
```

Exécutez-la depuis le répertoire où vous voulez les fichiers du projet. Après le scaffolding, poussez les ressources avec `npx base44 deploy`.

## Remarques

* **Modèle :** utilise toujours le modèle `backend-only` (uniquement configuration Base44 — aucun front-end généré).
* **Non interactif :** ne demande jamais. **Ne** pousse pas les entités et ne déploie pas le site. Utilisez `npx base44 deploy` ensuite pour pousser les ressources.
* **Application existante uniquement :** contrairement à `create`, elle ne crée pas de nouvelle application Base44 — elle lie les fichiers locaux à l'ID d'application fourni.
* **Authentification :** vous devez être authentifié (exécutez d'abord `npx base44 login`).
* Le fichier `.app.jsonc` doit être ignoré par git (il contient votre ID d'application).

<Note>Cette page a été traduite à l'aide de l'IA. Pour les informations les plus précises et à jour, consultez la [version anglaise](/). </Note>