create-twenty-app 2.19.0-alpha.1 → 2.20.0

package/dist/cli.mjs

@@ -30,7 +30,7 @@ var b = Object.create, x = Object.defineProperty, S = Object.getOwnPropertyDescr
 	enumerable: !0
 }) : n, e)), re = {
 	name: "create-twenty-app",
-	version: "2.19.0-alpha.1",
+	version: "2.20.0",
 	description: "Command-line interface to create Twenty application",
 	main: "dist/cli.cjs",
 	bin: "dist/cli.cjs",
@@ -12836,7 +12836,7 @@ function cp(e) {
 	return e != null;
 }
 //#endregion
-//#region ../twenty-shared/dist/types-B2Cms1AF.mjs
+//#region ../twenty-shared/dist/types-qzUQuYDF.mjs
 var lp = /* @__PURE__ */ function(e) {
 	return e.EMAIL = "EMAIL", e.CALENDAR = "CALENDAR", e.WORKFLOW = "WORKFLOW", e.AGENT = "AGENT", e.API = "API", e.IMPORT = "IMPORT", e.MANUAL = "MANUAL", e.SYSTEM = "SYSTEM", e.WEBHOOK = "WEBHOOK", e.APPLICATION = "APPLICATION", e;
 }({}), up = {
@@ -13295,6 +13295,13 @@ var vp = /* @__PURE__ */ function(e) {
 	DEVELOPERS_EXTEND_APPS_OPERATIONS_SYNC_AND_RECOVERY: "/developers/extend/apps/operations/sync-and-recovery",
 	DEVELOPERS_EXTEND_APPS_OPERATIONS_TESTING: "/developers/extend/apps/operations/testing",
 	DEVELOPERS_EXTEND_APPS_TRANSLATIONS_OVERVIEW: "/developers/extend/apps/translations/overview",
+	DEVELOPERS_EXTEND_APPS_TUTORIALS_DOCUMENT_GENERATOR_AI_AGENT: "/developers/extend/apps/tutorials/document-generator/ai-agent",
+	DEVELOPERS_EXTEND_APPS_TUTORIALS_DOCUMENT_GENERATOR_BUILDING_THE_UI: "/developers/extend/apps/tutorials/document-generator/building-the-ui",
+	DEVELOPERS_EXTEND_APPS_TUTORIALS_DOCUMENT_GENERATOR_DATA_MODEL: "/developers/extend/apps/tutorials/document-generator/data-model",
+	DEVELOPERS_EXTEND_APPS_TUTORIALS_DOCUMENT_GENERATOR_GENERATING_DOCUMENTS: "/developers/extend/apps/tutorials/document-generator/generating-documents",
+	DEVELOPERS_EXTEND_APPS_TUTORIALS_DOCUMENT_GENERATOR_HTTP_ROUTES: "/developers/extend/apps/tutorials/document-generator/http-routes",
+	DEVELOPERS_EXTEND_APPS_TUTORIALS_DOCUMENT_GENERATOR_OVERVIEW: "/developers/extend/apps/tutorials/document-generator/overview",
+	DEVELOPERS_EXTEND_APPS_TUTORIALS_DOCUMENT_GENERATOR_PUBLISHING: "/developers/extend/apps/tutorials/document-generator/publishing",
 	DEVELOPERS_EXTEND_OAUTH: "/developers/extend/oauth",
 	DEVELOPERS_EXTEND_WEBHOOKS: "/developers/extend/webhooks",
 	DEVELOPERS_INTRODUCTION: "/developers/introduction",
@@ -13431,7 +13438,7 @@ var vp = /* @__PURE__ */ function(e) {
 	A.RAW_JSON
 ]), yp.DAY, yp.WEEK, yp.MONTH, yp.QUARTER, yp.YEAR, A.TEXT, A.FULL_NAME, A.UUID;
 //#endregion
-//#region ../twenty-shared/dist/constants-I6AwDLlw.mjs
+//#region ../twenty-shared/dist/constants-D2kCMNsz.mjs
 var wp = [
 	"RATING_1",
 	"RATING_2",
@@ -60649,7 +60656,7 @@ function kk() {
 	return ak(Tk, arguments);
 }
 //#endregion
-//#region ../twenty-shared/dist/utils-nADfmWiY.mjs
+//#region ../twenty-shared/dist/utils-5DYZTZxt.mjs
 var Ak = /* @__PURE__ */ ne(aO(), 1);
 oO(), QO(), rk(), A.TEXT, A.FULL_NAME, A.EMAILS, A.ADDRESS, A.LINKS, A.PHONES, A.RICH_TEXT, A.UUID;
 var jk = (e) => /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(e);
@@ -63008,7 +63015,7 @@ var oM = (e) => {
 	let t = e.trim();
 	return t === "" ? t : oM(iM(t));
 };
-nu({ pattern: wn });
+nu({ pattern: wn }).max(255);
 var cM = (e) => /^{{[^{}]+}}$/.test(e), lM = /* @__PURE__ */ new Map();
 for (let e of Ok()) {
 	let t = kk(e), n = lM.get(t);
@@ -63260,7 +63267,7 @@ var uM = (e) => typeof e == "string", dM = RegExp("\\{\\{([^{}]+)\\}\\}", "g"),
 		let i = a(t);
 		console.log(e.green("\n✔ Application created successfully!\n")), console.log(e.white("  Next steps:\n"));
 		let o = 1;
-		console.log(e.white(`  ${o}. Navigate to your project`)), console.log(e.cyan(`     cd ${i}\n`)), o++, r || (console.log(e.white(`  ${o}. Connect to a Twenty instance`)), console.log(e.cyan("     yarn twenty remote:add --url <your-instance-url>\n")), o++), console.log(e.white(`  ${o}. Start developing`)), console.log(e.cyan("     yarn twenty dev\n")), o++, console.log(e.white(`  ${o}. Open your twenty instance`)), console.log(e.cyan(`     ${n}\n`)), console.log(e.gray("  Documentation: https://docs.twenty.com/developers/extend/capabilities/apps"));
+		console.log(e.white(`  ${o}. Navigate to your project`)), console.log(e.cyan(`     cd ${i}\n`)), o++, r || (console.log(e.white(`  ${o}. Connect to a Twenty instance`)), console.log(e.cyan("     yarn twenty remote:add --url <your-instance-url>\n")), o++), console.log(e.white(`  ${o}. Start developing`)), console.log(e.cyan("     yarn twenty dev\n")), o++, console.log(e.white(`  ${o}. Open your twenty instance`)), console.log(e.cyan(`     ${n}\n`)), console.log(e.gray("  Documentation: https://docs.twenty.com/developers/extend/apps/getting-started/quick-start"));
 	}
 }, SM = new t(re.name).description("CLI tool to initialize a new Twenty application").version(re.version, "-v, --version", "Output the current version of create-twenty-app.").argument("[directory]").option("-n, --name <name>", "Application name").option("-d, --display-name <displayName>", "Application display name").option("--description <description>", "Application description").option("--url <url>", "Twenty server URL (default: http://localhost:2020)").option("--api-url <apiUrl>", "[deprecated: use --url]").option("--authentication-method <method>", "Authentication method: oauth or apiKey (default: apiKey for local, oauth for remote)").helpOption("-h, --help", "Display this help message.").action(async (t, n) => {
 	t && !/^[a-z0-9-]+$/.test(t) && (console.error(e.red(`Invalid directory "${t}". Must contain only lowercase letters, numbers, and hyphens`)), process.exit(1)), n?.name !== void 0 && n.name.trim().length === 0 && (console.error(e.red("Error: --name cannot be empty.")), process.exit(1)), n?.authenticationMethod && !["oauth", "apiKey"].includes(n.authenticationMethod) && (console.error(e.red("Error: --authentication-method must be \"oauth\" or \"apiKey\".")), process.exit(1)), n?.apiUrl && console.warn(e.yellow("Warning: --api-url is deprecated. Use --url instead."));

package/dist/constants/template/AGENTS.md

@@ -63,5 +63,9 @@ It's highly recommended to create new app entities using `yarn twenty dev:add`.
 | View                 | `yarn twenty dev:add view`               | `src/views/<name>.ts`                 |
 | Navigation menu item | `yarn twenty dev:add navigationMenuItem` | `src/navigation-menu-items/<name>.ts` |
 | Page layout          | `yarn twenty dev:add pageLayout`         | `src/page-layouts/<name>.ts`          |
+| Page layout tab      | `yarn twenty dev:add pageLayoutTab`      | `src/page-layout-tabs/<name>.ts`      |
+| Command menu item    | `yarn twenty dev:add commandMenuItem`    | `src/command-menu-items/<name>.ts`    |
+| View field           | `yarn twenty dev:add viewField`          | `src/view-fields/<name>.ts`           |
+| Connection provider  | `yarn twenty dev:add connectionProvider` | `src/connection-providers/<name>.ts`  |
 
 This helps automatically generate required IDs etc.

package/dist/constants/template/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+All notable changes to this application are documented in this file.
+
+## 0.1.0
+
+- Initial application scaffolded with [`create-twenty-app`](https://www.npmjs.com/package/create-twenty-app)

package/dist/constants/template/README.md

@@ -1,24 +1,24 @@
-This is a [Twenty](https://twenty.com) application bootstrapped with [`create-twenty-app`](https://www.npmjs.com/package/create-twenty-app).
+# My Twenty App
 
-## Getting Started
+Describe your app in one or two sentences.
 
-This app was scaffolded with a local Twenty server running at [http://localhost:2020](http://localhost:2020).
+## Features
 
-Login with the default development credentials: `tim@apple.dev` / `tim@apple.dev`.
+List the top things your app does, for example:
 
-Run `yarn twenty help` to list all available commands.
+- Feature one
+- Feature two
+- Feature three
 
-## Useful Commands
+## Getting started
 
-- `yarn twenty dev` - Start the development server and sync your app
-- `yarn twenty docker:status` - Check the local Twenty server status
-- `yarn twenty docker:start` - Start the local Twenty server
-- `yarn lint` - Lint the project with oxlint
-- `yarn typecheck` - Type-check the project
-- `yarn test:unit` - Run unit tests
-- `yarn test` - Run integration tests
+Setup instructions live in [SETUP.md](SETUP.md).
 
-## Learn More
+## Changelog
+
+Notable changes are documented in [CHANGELOG.md](CHANGELOG.md).
+
+## Learn more
 
 - [Twenty Apps documentation](https://docs.twenty.com/developers/extend/apps/getting-started/quick-start)
 - [twenty-sdk CLI reference](https://www.npmjs.com/package/twenty-sdk)

package/dist/constants/template/SETUP.md

@@ -0,0 +1,44 @@
+# Setup
+
+Follow these steps to get your app running locally.
+
+## Prerequisites
+
+- Node.js (version specified in `.nvmrc`)
+- Yarn 4
+- Docker (to run the local Twenty server)
+
+## Steps
+
+1. Install dependencies:
+
+   ```bash
+   yarn install
+   ```
+
+2. Start the local Twenty server:
+
+   ```bash
+   yarn twenty docker:start
+   ```
+
+   Check the server status at any time with `yarn twenty docker:status`.
+
+3. Start the development server and sync your app:
+
+   ```bash
+   yarn twenty dev
+   ```
+
+4. Open [http://localhost:2020](http://localhost:2020) and log in with the default development credentials: `tim@apple.dev` / `tim@apple.dev`.
+
+## Verifying your setup
+
+- `yarn lint` - Lint the project with oxlint
+- `yarn typecheck` - Type-check the project
+- `yarn test:unit` - Run unit tests
+- `yarn test` - Run integration tests
+
+## Troubleshooting
+
+See the [troubleshooting guide](https://docs.twenty.com/developers/extend/apps/getting-started/troubleshooting) or ask on [Discord](https://discord.gg/cx5n4Jzs57).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-twenty-app",
-  "version": "2.19.0-alpha.1",
+  "version": "2.20.0",
   "description": "Command-line interface to create Twenty application",
   "main": "dist/cli.cjs",
   "bin": "dist/cli.cjs",
@@ -34,7 +34,7 @@
     "lodash.camelcase": "^4.3.0",
     "lodash.kebabcase": "^4.1.1",
     "lodash.startcase": "^4.4.0",
-    "twenty-sdk": "2.19.0-alpha.1",
+    "twenty-sdk": "2.20.0",
     "uuid": "^13.0.2"
   },
   "devDependencies": {

package/src/constants/template/README.md

@@ -1,24 +1,24 @@
-This is a [Twenty](https://twenty.com) application bootstrapped with [`create-twenty-app`](https://www.npmjs.com/package/create-twenty-app).
+# My Twenty App
 
-## Getting Started
+Describe your app in one or two sentences.
 
-This app was scaffolded with a local Twenty server running at [http://localhost:2020](http://localhost:2020).
+## Features
 
-Login with the default development credentials: `tim@apple.dev` / `tim@apple.dev`.
+List the top things your app does, for example:
 
-Run `yarn twenty help` to list all available commands.
+- Feature one
+- Feature two
+- Feature three
 
-## Useful Commands
+## Getting started
 
-- `yarn twenty dev` - Start the development server and sync your app
-- `yarn twenty docker:status` - Check the local Twenty server status
-- `yarn twenty docker:start` - Start the local Twenty server
-- `yarn lint` - Lint the project with oxlint
-- `yarn typecheck` - Type-check the project
-- `yarn test:unit` - Run unit tests
-- `yarn test` - Run integration tests
+Setup instructions live in [SETUP.md](SETUP.md).
 
-## Learn More
+## Changelog
+
+Notable changes are documented in [CHANGELOG.md](CHANGELOG.md).
+
+## Learn more
 
 - [Twenty Apps documentation](https://docs.twenty.com/developers/extend/apps/getting-started/quick-start)
 - [twenty-sdk CLI reference](https://www.npmjs.com/package/twenty-sdk)