Create DECAF Web Application

Create DECAF Web applications with zero or minimal configuration.

• Create DECAF Webapp works on macOS and Linux.

• It may work on Windows, but it is not officially supported.

• If something doesn’t work, please file an issue.

Overview

npx create-decaf-webapp@latest my-app -a "My App"
cd my-app
npm run dev

You can also install it globally with npm i -g create-decaf-webapp. But to ensure you always use the latest version, it is recommended to use npx.

Then open http//localhost:3000/webapps/my-app/development/ to see your app.

Changelog

0.8.0 (2025-04-28)

⚠ BREAKING CHANGES

• template: upgrade the minimum Node version to 22

Miscellaneous Chores

• template: upgrade dependencies (cf62051)

0.7.0 (2024-12-31)

⚠ BREAKING CHANGES

• now minimum engine version is 22

Features

• upgrade decaf library versions (e2eee52)

Miscellaneous Chores

• upgrade dependencies (e2eee52)

0.6.2 (2024-09-18)

Features

• the default theme is now dark (bd2694f)
• upgrade to eslint 9 and add graphql-zeus integration (0439eb7)

Bug Fixes

• update husky commands and start log (4cd402d)

0.6.1 (2024-01-12)

Miscellaneous Chores

• upgrade dependencies (7418992)

0.6.0 (2023-12-13)

⚠ BREAKING CHANGES

• min. required node version to run the apps is now 20
• set project type to module

Features

• set project type to module (f3fb1ce)

Miscellaneous Chores

• min. required node version to run the apps is now 20 (9462162)

0.5.0 (2023-12-04)

⚠ BREAKING CHANGES

• drop support for Node 16

Miscellaneous Chores

• drop support for Node 16 (982be75)

0.4.10 (2023-10-10)

Miscellaneous Chores

• upgrade dependencies (82cc8f7)

0.4.9 (2023-09-25)

Bug Fixes

• dev commands and initial version is wrong (1bca344)

0.4.8 (2023-09-11)

Features

• add prettier-plugin-organize-imports plugin (5968051)

0.4.7 (2023-09-11)

Features

• adopt next.js conventions for script names (303ec70)
• generate husky hooks (d078b30)

0.4.6 (2023-08-17)

Features

• enable path aliases for src folder (3984738)
• new, up-to-date eslint setup (a2ff79e)

Bug Fixes

• set initial version to 0.0.1 on release-please (92a30de)

0.4.5 (2023-08-10)

Miscellaneous Chores

• upgrade dependencies (01e0382)

0.4.4 (2023-07-03)

Miscellaneous Chores

• release: release 0.4.4 (6d07818)

0.4.3 (2023-07-01)

Features

• enable production mode previewing with proxy support (3807341)
• integrate codegen script for type generation from graphql schema (926ba54)

0.4.2 (2023-05-30)

Bug Fixes

• generate version.json after build (c08516b)

0.4.1 (2023-05-25)

Features

• use commander for cli parsing and interface (ea6b24b)

Bug Fixes

• current node version's major is used as string (5c209fd)

0.4.0 (2023-05-19)

⚠ BREAKING CHANGES

• upgrade dependencies

Bug Fixes

• add missing package-lock.json (3638052)

Miscellaneous Chores

• upgrade dependencies (29000bb)

0.3.0 (2023-05-17)

⚠ BREAKING CHANGES

• migrate to Vite

Features

• migrate to Vite (f10f3f1)

0.2.3 (2023-05-11)

Bug Fixes

• project name is not being updated in some action files (bd2caf2)

0.2.2 (2023-05-11)

Features

• get app display name as an optional second parameter (2b682bc)

0.2.1 (2023-05-11)

Bug Fixes

• override typescript for react-scripts (7ba009d)

0.2.0 (2023-05-11)

⚠ BREAKING CHANGES

• make minimum supported node version 16

Bug Fixes

• check for invalid project names (d5df88d)

Miscellaneous Chores

• make minimum supported node version 16 (f5de11b)

0.1.0 (2023-05-11)

⚠ BREAKING CHANGES

• upgrade dependencies

Miscellaneous Chores

• upgrade dependencies (6535791)

0.0.7 (2023-04-02)

Miscellaneous Chores

• upgrade template dependencies (a62e0b0)

0.0.6 (2023-03-08)

Bug Fixes

• deps: downgrade chalk to 4 (6b9c580)

0.0.5 (2023-03-08)

Bug Fixes

• deps: upgrade dependencies (01cb609)

0.0.4 (2023-02-28)

Bug Fixes

• move testing packages to dev dependencies section (8eb4f08)

0.0.3 (2023-02-27)

⚠ BREAKING CHANGES

• deps: upgrade template dependencies

Miscellaneous Chores

• deps: upgrade template dependencies (c038735)
• release 0.0.3 (1cd3f80)

0.0.2 (2023-02-01)

Bug Fixes

• do not use yarn and yarn cache while publishing (7503be0)

0.0.1 (2023-02-01)

Features

• initialize codebase (cf787b7)

Bug Fixes

• do not install as dev dependencies (fb1a46c)
• ignore yarn.lock files (5065765)
• pass default value for decaf webapp host (90c8248)
• use node 16 LTS instead of Node 18 (27049dd)

Miscellaneous Chores

• release 0.0.1 (c4fa1a0)