automatic integration and configuration from the community
npm install ember-apply
_Automatic integration and configuration from the community._
See the Documentation.
This is a framework and ecosystem agnostic collection of recommended configurations,
applied via automation, that is compatible with any kind of project, new and old.
Individual configurations may have conventions specific to a an ecosystem, but ember-apply,
itself, can be used with Svelte, React, or
whatever you want. The tools provided by ember-apply only require Node 16+.
Maybe most importantly, is that ember-apply can be used for any tool that wishes
to use high-level project-management and transformation utilities.
See #Public API.
_NOTE:_ this package is a slightly experimental and prone to some API or organizational changes -- but is committed to strictly following semver.
``shell`
npx ember-apply
where is one of the options under #Features
* Node 16 +
* ESM
`shell`
npx ember-apply typescript
_Automates setting up TypeScript for your V1 Addon or App._
- correct dependencies
- correct types
- correct configs
`shell`
npx ember-apply volta
_Automates setting up volta in a project, monorepo or solorepo_.
- root package.json defines node version
- if monorepo, all other packages extend from the root package.json
`shell`
npx ember-apply tailwind
_Automates the steps from Tailwind's installation docs_
Known working capabilities:
- JIT
- Rebuilding during development
Assumptions
- entrypoint for your app is located at app/index.htmltests/index.html
- entrypoint for your tests is located at config/tailwind/
- tailwind files are placed in
`shell`
npx ember-apply tailwind-webpack
_Automates the official Tailwind + Ember.js guide_
- Instead of placing postcss.config.js and tailwind.config.js into the project root, it places them to config/ directory.npm start
- Does not need any special command for building tailwind styles they will be built (and watched) together with .
`shell`
npx ember-apply tailwind3-vite
_Automates the official Tailwind + Vite guide so that it's compatible with @embroider/app-blueprint_
`shell`
npx ember-apply tailwind4-vite
_Automates the official Tailwind + Vite guide so that it's compatible with @embroider/app-blueprint_
`shell`
npx ember-apply embroider
_Automates the embroider migration from the classic ember build system for maximum-compatibility mode_.
See the Embroider docs
implementation tbd (pr's welcome!)
`shell`
npx ember-apply ssr
Known working capabilities:
- tbd
when using a package name for the , an ESM version of the package
will attempt to be loaded and used, invoking the default export.
`shell`
npx ember-apply @scope/feature-name
Local scripts may also be used. An example of this is maybe in a private monorepo
where some scripts or packages aren't published to npm.
`shell`
npx ember-apply ../../path/to/some/script.js # ESM requiredor
npx ember-apply ../../path/to/some/script.mjs
- clone this repository
- create a packages/ filepackages/ember/tailwind/index.js
examples:
- packages/sveltekit/tailwind/index.js
- ember-apply
- have a function exported as the default export.
within this function, you may import form to use any of the utility functions.npx ember-apply
the only argument passed to this function is the working directory was invoked from.
how the folder is managed is totally up to whomever implements and maintains that code.
JSCodeShift is used
ember-template-recast is used
posthtml is used
- preset
GOAL (tbd): be compatible with npx apply
- preset does not provide codemodding tools, butpreset
it does provide basic pattern-based transforming
utilities, so it's a solid option. It also does
not have built-in support for template transforms.
- currently, forces the install of esbuild which fails due to having the security feature ignore-scripts enabled, so preset is a non-option for folks who carepreset`)
about security. (or who don't mind adding an allow-list for