@agametis/create-app-for-fm

A CLI tool for quickly creating JavaScript projects for FileMaker applications.

Features

• Creates projects from maintained FileMaker templates
• Supports new or empty current directories
• Installs npm dependencies
• Provides a dedicated AI-assisted widget template command
• Shows localized next steps in German or English

Requirements

• Node.js 22 or newer for the general CLI
• Node.js 24 or newer for the ai command
• Git

Use with npx

# Interactive template selection (default)
npx @agametis/create-app-for-fm@latest
npx @agametis/create-app-for-fm@latest create

# AI-assisted FileMaker widget template
npx @agametis/create-app-for-fm@latest ai my-widget

# Prompt for the AI project directory
npx @agametis/create-app-for-fm@latest ai

# Use an empty current directory
npx @agametis/create-app-for-fm@latest ai .

# Other commands
npx @agametis/create-app-for-fm@latest list
npx @agametis/create-app-for-fm@latest info <template-name>
npx @agametis/create-app-for-fm@latest init
npx @agametis/create-app-for-fm@latest --help

The ai command refuses non-empty targets. It downloads agametis/fm-starter-ai, installs dependencies, initializes Git, and creates a baseline commit when user.name and user.email are configured.

The generated project includes the portable, project-local aga-fm-widget Agent Skill. Open the project in an Agent Skills-compatible coding environment and ask the agent to use aga-fm-widget.

Install globally

npm install -g @agametis/create-app-for-fm
create-app-for-fm --help
create-app-for-fm ai my-widget

Approve the post-install script when npm asks

Recent npm versions may warn that this package's postinstall script is not covered by your allowScripts policy. The script runs only for global installs: it confirms the installation, suggests create-app-for-fm --help, and shows the built-in help in an interactive terminal. It does not modify your project or download anything. The CLI remains usable if the script is not run, but approving it preserves that installation guidance and prepares for npm versions that block unapproved install scripts.

For a project installation, review pending scripts and approve this package after reviewing it:

npm approve-scripts --allow-scripts-pending
npm approve-scripts @agametis/create-app-for-fm

npm approve-scripts cannot approve scripts for global installs or npx because they have no project package.json. For a global install, allow this package's script at install time instead:

npm install -g \
  --allow-scripts=@agametis/create-app-for-fm \
  @agametis/create-app-for-fm

To uninstall:

npm uninstall -g @agametis/create-app-for-fm

Available templates

• fm-starter-ai: AI-assisted React TypeScript template with a guided FileMaker widget workflow
• fm-starter-vite: General FileMaker project template
• fm-starter-react: React template
• fm-starter-react-ts: React TypeScript template
• fm-image-gallery: Image Gallery widget
• fm-google-maps-starter: Google Maps integration
• fm-react-demo: React/FileMaker integration demo
• fmk2022_demos, fmk2023_demos, fmk2024_demos: Conference examples

Development

npm install
npm test
node src/cli.js --help
npm pack --dry-run

License

MIT