From 83300ad57d892617e3b3fd069ac773ddc39b1233 Mon Sep 17 00:00:00 2001 From: johnxie Date: Thu, 12 Nov 2026 12:11:38 -0800 Subject: [PATCH 1/2] docs: Name the version history twin by its new title The taskade.com/learn article is now "Version History & Restore". Two page footers still used the old title "App Revisions & Restore". The lock file has the new hash of that twin. --- .github/twins.lock.json | 2 +- genesis-living-system-builder/genesis/version-history.md | 2 +- .../space-apps-guide/advanced-features.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/twins.lock.json b/.github/twins.lock.json index ab8e2b3..2caec5c 100644 --- a/.github/twins.lock.json +++ b/.github/twins.lock.json @@ -583,7 +583,7 @@ ] }, "https://www.taskade.com/learn/genesis/version-history": { - "sha256": "bd0439be658fb248b5ef4a47411ecaa395354ad03f4c06ce2a7e8daff31a9803", + "sha256": "129ef36107380409f1243396d51dc1dbf07e971c644d01d73ceba3b140d24f1c", "pages": [ "genesis-living-system-builder/genesis/version-history.md", "genesis-living-system-builder/space-apps-guide/advanced-features.md" diff --git a/genesis-living-system-builder/genesis/version-history.md b/genesis-living-system-builder/genesis/version-history.md index 630cbed..f64b6ac 100644 --- a/genesis-living-system-builder/genesis/version-history.md +++ b/genesis-living-system-builder/genesis/version-history.md @@ -149,4 +149,4 @@ Prefer **Manual** publish for any Genesis app in active use. It gives you a revi --- -_Step-by-step guide on taskade.com/learn: [App Revisions & Restore](https://www.taskade.com/learn/genesis/version-history)._ +_Step-by-step guide on taskade.com/learn: [Version History & Restore](https://www.taskade.com/learn/genesis/version-history)._ diff --git a/genesis-living-system-builder/space-apps-guide/advanced-features.md b/genesis-living-system-builder/space-apps-guide/advanced-features.md index 904a111..2c7a8da 100644 --- a/genesis-living-system-builder/space-apps-guide/advanced-features.md +++ b/genesis-living-system-builder/space-apps-guide/advanced-features.md @@ -995,4 +995,4 @@ See [Custom Domains & Branding](custom-domains.md). --- -_Step-by-step guides on taskade.com/learn: [App Revisions & Restore](https://www.taskade.com/learn/genesis/version-history), [Publish Agents Publicly](https://www.taskade.com/learn/agents/public-agents)._ +_Step-by-step guides on taskade.com/learn: [Version History & Restore](https://www.taskade.com/learn/genesis/version-history), [Publish Agents Publicly](https://www.taskade.com/learn/agents/public-agents)._ From f41cf2ff9643dc63750ad7fbc5d80565a6c5dacc Mon Sep 17 00:00:00 2001 From: johnxie Date: Thu, 12 Nov 2026 12:32:59 -0800 Subject: [PATCH 2/2] docs: Bring 57 pages up to date with their taskade.com articles and simplify the wording The weekly drift check reported 50 taskade.com articles that changed after the last comparison. Each GitBook page now uses the labels, steps, limits and plan gates of the product today. The pages use plain English. Claims that have no source in the product are removed. The lock file has the new hash of each reviewed article. --- .github/twins.lock.json | 100 +-- account-management/README.md | 10 +- account-management/credits-and-billing.md | 131 +-- .../agent-embeds.md | 65 +- .../autonomous-agents.md | 45 +- apis-living-system-development/bundles.md | 12 +- .../genesis-app-mcp.md | 60 +- .../workspace-mcp-advanced.md | 12 +- .../ai-features/README.md | 59 +- .../ai-features/agent-knowledge.md | 172 ++-- .../ai-features/agent-teams.md | 102 ++- .../ai-features/agent-tools.md | 164 ++-- .../ai-features/ai-agents-getting-started.md | 809 +++++++++--------- .../ai-features/multi-agents.md | 129 +-- .../automation/README.md | 108 +-- .../automation/actions.md | 791 ++++++++--------- .../automation/advanced-actions.md | 135 +-- .../automation/ai-forms.md | 207 ++--- .../comprehensive-integration-guide.md | 72 +- .../automation/comprehensive-integrations.md | 58 +- .../automation/integrations.md | 174 ++-- .../automation/workflow-generator.md | 110 +-- .../community-and-sharing/README.md | 619 +++++++------- .../community-and-sharing/faq.md | 351 ++++---- .../community-and-sharing/genesis-auth.md | 91 +- .../publish-and-clone.md | 290 ++++--- .../community-and-sharing/troubleshooting.md | 232 ++--- .../genesis/README.md | 37 +- .../genesis/adding-context.md | 100 ++- .../genesis/debugging-genesis-apps.md | 144 ++-- .../genesis/getting-started.md | 296 ++++--- .../genesis/how-genesis-works.md | 274 +++--- .../genesis/workspace-dna.md | 128 +-- .../run-your-business/add-login-and-roles.md | 79 +- .../build-a-client-portal.md | 56 +- .../build-an-ops-dashboard.md | 42 +- .../from-idea-to-live-business.md | 30 +- .../run-your-business/go-live-checklist.md | 24 +- .../space-apps-guide/README.md | 311 ++++--- .../space-apps-guide/advanced-features.md | 516 +++++------ .../space-apps-guide/custom-domains.md | 385 +++++---- .../workspaces/advanced-search-navigation.md | 201 ++--- .../workspaces/editing-formatting.md | 165 ++-- .../workspaces/knowledge-management.md | 105 ++- .../workspaces/markdown.md | 127 ++- .../workspaces/mobile-optimization.md | 210 ++--- .../workspaces/project-views.md | 178 ++-- .../workspaces/projects-databases.md | 18 +- getting-started/README.md | 151 ++-- help-and-support/index/02_projects.md | 182 ++-- help-and-support/index/03_ai_agents.md | 199 ++--- help-and-support/index/04_automation.md | 278 +++--- help-and-support/index/05_genesis.md | 226 ++--- help-and-support/index/06_integrations.md | 323 ++++--- help-and-support/index/08_mobile_desktop.md | 208 +++-- help-and-support/index/README.md | 68 +- help-center/import-and-export.md | 172 ++-- help-center/mobile-app.md | 144 ++-- 58 files changed, 5460 insertions(+), 5025 deletions(-) diff --git a/.github/twins.lock.json b/.github/twins.lock.json index 2caec5c..1f2439a 100644 --- a/.github/twins.lock.json +++ b/.github/twins.lock.json @@ -42,19 +42,19 @@ ] }, "https://www.taskade.com/docs/guides/agent-embeds": { - "sha256": "b6659a4e1ff04627d730dc5e8dcdad52861164f503f8b5cbe209f09e835c90aa", + "sha256": "a7d1b03f0c90c730a21b1e7c0dea494f1f4ea5597226900651aedff63c084b4f", "pages": [ "apis-living-system-development/agent-embeds.md" ] }, "https://www.taskade.com/docs/guides/autonomous-agents": { - "sha256": "f90bc9f0458735abb030603ca38b1b11eb102ef44ca4742fed743f13286a18b3", + "sha256": "89d3a489ad7ce5e622c4e129200d062531e72b684eb41ed956bac0609077f98f", "pages": [ "apis-living-system-development/autonomous-agents.md" ] }, "https://www.taskade.com/docs/guides/bundles": { - "sha256": "1bde99cef7f5004e22c1f4d0dcb8b8269c693bf3e63c02ad0f1fa8d218c0f5ae", + "sha256": "9b456b4fb95d3d472c302b05c10603da7cde6afac8eff843d67f7012c65ef1fc", "pages": [ "apis-living-system-development/bundles.md" ] @@ -84,7 +84,7 @@ ] }, "https://www.taskade.com/docs/mcp/hosted-mcp": { - "sha256": "504248e682a104d817930c61d531dcf2d2be7754fae576443e8cb6124ae85298", + "sha256": "5abd7c829654bc143c749917ece3b1f07865cff223ad8f303b3df82b8568e286", "pages": [ "apis-living-system-development/genesis-app-mcp.md" ] @@ -108,7 +108,7 @@ ] }, "https://www.taskade.com/docs/mcp/workspace-mcp-advanced": { - "sha256": "60f5fd3c5bf583315dd75e5ccc13f80df1145223db19dc1eae5ac238995fa2a6", + "sha256": "e665cfc3293d4df239b7c03ccb9e31930468213b0c399e80666df2d6dd34d73e", "pages": [ "apis-living-system-development/workspace-mcp-advanced.md" ] @@ -120,13 +120,13 @@ ] }, "https://www.taskade.com/learn/account/billing-faq": { - "sha256": "2f1df92a824dc1e96cadf2bb68613447bb7123dbcb14defc390fb5648fe18b5f", + "sha256": "4ee0dd386acb4998bf3591459bd894f755c4e4a230bc1cf5c95c21bc2c2c88de", "pages": [ "account-management/credits-and-billing.md" ] }, "https://www.taskade.com/learn/account/desktop-settings": { - "sha256": "ee1c33816d441482b4e6147ceab4a97fc1beefedab77e439c23714bd308b0eb1", + "sha256": "e5c7abf5b402c42469ccec6b753185329fd42bb15d1b045dfde275e5808772a0", "pages": [ "help-and-support/index/08_mobile_desktop.md" ] @@ -150,7 +150,7 @@ ] }, "https://www.taskade.com/learn/account/plan-matrix": { - "sha256": "de47a9ca5c0d9a076aca40c484a5100b99cc10ccf2ac3a772bc360197299d4cf", + "sha256": "d1c891596381bc30be48b5806bdc75c42f0ad9e0d38c12c0605ad96dd73f14cd", "pages": [ "account-management/README.md" ] @@ -170,7 +170,7 @@ ] }, "https://www.taskade.com/learn/account/what-is-taskade": { - "sha256": "0418d5f8e2771897d8a4d9591d54c5674650cb79be9b5bc31211659a4e8fd876", + "sha256": "9597c9976434afe17eafeaf21035df406c32947c98db23d6e9c2e992572b4863", "pages": [ "help-and-support/index/README.md" ] @@ -183,13 +183,13 @@ ] }, "https://www.taskade.com/learn/agents/agent-playbook": { - "sha256": "b9e792b092f8bf21018ddd215f34521e3ea5b398683aad2fc7a3248e75f518d3", + "sha256": "1748d41cb1df8c8f9b1072f2fc418ffa0530d71b855b3a5a41191a9199e78c52", "pages": [ "genesis-living-system-builder/ai-features/ai-agents-getting-started.md" ] }, "https://www.taskade.com/learn/agents/agent-tools": { - "sha256": "af1d57add24a8f40769685bb5cb8ff88d1b18cc80b687328a69d4cc5c8a61f45", + "sha256": "fd8cb02ac897b83e99e67012ba1c2efc92072ef5791358f31dc5661f65f7087d", "pages": [ "genesis-living-system-builder/ai-features/agent-tools.md" ] @@ -207,7 +207,7 @@ ] }, "https://www.taskade.com/learn/agents/ai-teams": { - "sha256": "fa6a9ad91518f22bf13247ff3931ff7542b51d2d8e565ec70997e7da6cbd8d01", + "sha256": "09bce12882c317b1f0122e09bb7e6d5f5931b69838edf8104c0243a93f2719ee", "pages": [ "genesis-living-system-builder/ai-features/agent-teams.md", "genesis-living-system-builder/ai-features/ai-agents-getting-started.md", @@ -216,13 +216,13 @@ ] }, "https://www.taskade.com/learn/agents/ai-usage": { - "sha256": "0863a83b341e7d699ff1d5525c24327538624666f1ace48817ff464634572907", + "sha256": "d963e6cab59bb6bf476af40da5971c56d700a316f00676494cf24d992f51bff7", "pages": [ "account-management/credits-and-billing.md" ] }, "https://www.taskade.com/learn/agents/custom-agents": { - "sha256": "d2d659a4654cff7214db06cd17d3d7e8821fbd512938969dc10dee84f90385a7", + "sha256": "2c202daea097fab83fac2f567ae515fa941dea7407e42d0c412e831b812522c6", "pages": [ "genesis-living-system-builder/ai-features/README.md", "genesis-living-system-builder/ai-features/ai-agents-getting-started.md", @@ -236,7 +236,7 @@ ] }, "https://www.taskade.com/learn/agents/knowledge": { - "sha256": "4934c2e685619b875906a77a8176a9e6be21b7e9d05d7aa75bd7a4e6d22c65b6", + "sha256": "eb2842c9a1b8de0cac0b21e1402c680393865eed82703e256d98b5b5d96f771d", "pages": [ "genesis-living-system-builder/ai-features/agent-knowledge.md", "genesis-living-system-builder/workspaces/knowledge-management.md", @@ -269,13 +269,13 @@ ] }, "https://www.taskade.com/learn/agents/public-agents": { - "sha256": "b0b6115aaa8402e202037b21fd4045f730d9b84d9958e679a62f78d89e1b0985", + "sha256": "96c54f1df895f5ac20c7561efbc2c20f3347babec956da8dcaac86d128dc8ac2", "pages": [ "genesis-living-system-builder/space-apps-guide/advanced-features.md" ] }, "https://www.taskade.com/learn/agents/team-generator": { - "sha256": "601de076424c7818693e0f190fb7aa20e82e92a551819532d7733ab4dfaaa3db", + "sha256": "154ae3a9823fca622a41f64acebfd2fb0eb9fa0e7c50916b4bc3bac6e163d317", "pages": [ "genesis-living-system-builder/ai-features/agent-teams.md" ] @@ -287,7 +287,7 @@ ] }, "https://www.taskade.com/learn/automation/actions": { - "sha256": "fadadfc24346279c9b12b1f8da49a70ab9e30afffaadd9fa7555d4fffe6396c0", + "sha256": "318e3f0d887ef0394cc4bdeac1963a0e9a77fcc79f059206eec3b6641d099de0", "pages": [ "genesis-living-system-builder/automation/README.md", "genesis-living-system-builder/automation/actions.md", @@ -297,14 +297,14 @@ ] }, "https://www.taskade.com/learn/automation/automations-execution": { - "sha256": "9e1c909481f0549d136d53d51c686676c9ed8c96f9013fdea37332d20cde8963", + "sha256": "d29e8731ec3540076b4d283ab4c5a2bae4dc2ecfc36f3d0f665e1f08c774cdd2", "pages": [ "genesis-living-system-builder/automation/README.md", "help-and-support/index/04_automation.md" ] }, "https://www.taskade.com/learn/automation/forms-trigger": { - "sha256": "33e2729f1c14aa896fab760e0cc70a8225c45f72ba4dd629960f5161308261e7", + "sha256": "7add84d309dc58743e7fa95ed055de547837b0a8f88145fe3ee5f8a6ca359dbf", "pages": [ "genesis-living-system-builder/automation/ai-forms.md" ] @@ -316,7 +316,7 @@ ] }, "https://www.taskade.com/learn/automation/loop-action": { - "sha256": "0f2554610e9c16a3675869458dc1c75f40cd203b8a18a76d63d7ed85bcde40be", + "sha256": "02592f33bb3febd19db439a502c74667b5d6e4216068d9daaa140ad184dc9474", "pages": [ "genesis-living-system-builder/automation/advanced-actions.md" ] @@ -337,7 +337,7 @@ ] }, "https://www.taskade.com/learn/automation/workflow-generator": { - "sha256": "7becd1afae78266fb8d7fdc7c12bdf118c95e885bf2756677bf5a4804cf56bc7", + "sha256": "7312acc2f69cfde0593afe0c706b8c317b66539e04310adb3ca4856bdd654efc", "pages": [ "genesis-living-system-builder/automation/workflow-generator.md" ] @@ -355,7 +355,7 @@ ] }, "https://www.taskade.com/learn/connect/everywhere": { - "sha256": "86db68bebb34668d55b05368f232dc2b864aedb2d579cf48207c8dbbaf6c605a", + "sha256": "5ad60c9235fa17159afbcc86c6f16318c1fb7d3d154239cf60d1b62c665b8c69", "pages": [ "genesis-living-system-builder/automation/comprehensive-integration-guide.md", "genesis-living-system-builder/automation/integrations.md", @@ -363,7 +363,7 @@ ] }, "https://www.taskade.com/learn/connect/google-drive": { - "sha256": "83031415674e614614c1ae807aa3f71c08e15ba35e76e6166b9335beae8e4364", + "sha256": "480981e4623f247a852d73061f01e3cf0aac4201eb201c116db0eb62e6e394d8", "pages": [ "help-and-support/index/06_integrations.md" ] @@ -375,13 +375,13 @@ ] }, "https://www.taskade.com/learn/connect/slack-integration": { - "sha256": "7f95b7a9d8dea84245ca46ec1bc1b6981cc46635ab3d7f0b2d3193fdad872163", + "sha256": "7d95709615a8e94ebdd3138fb58113e7d18dc10bd6bfc75778ccb5b3000a9ec7", "pages": [ "help-and-support/index/06_integrations.md" ] }, "https://www.taskade.com/learn/connect/whatsapp": { - "sha256": "3b73fd07d5d294106ced87d1311abdcd776e11c39ceef2ba07c04b41ed6222ea", + "sha256": "cd34cd6fdb503183b476399358f7977f4d2ac33b9c4045b55709609fb142eff3", "pages": [ "genesis-living-system-builder/automation/advanced-actions.md" ] @@ -393,7 +393,7 @@ ] }, "https://www.taskade.com/learn/genesis/app-context": { - "sha256": "1b1e2d31c203f1fd47fa9a9e3f11b860258fe9fe853597671a4ba9109d6d1d2a", + "sha256": "9d8343b235f331e13f093d22d390ad8a1b179b4d3ebc7605fd1fdf8d8d85ce4c", "pages": [ "genesis-living-system-builder/genesis/adding-context.md" ] @@ -405,7 +405,7 @@ ] }, "https://www.taskade.com/learn/genesis/app-users": { - "sha256": "9eb714c80fb28042098834c61b3baf0eb60efcf7fe8c9feda065cb320c51bc6c", + "sha256": "427662cc73d4b124f7da70153482aedfd70b1e73382ab1f50819195ae748651c", "pages": [ "genesis-living-system-builder/community-and-sharing/genesis-auth.md", "genesis-living-system-builder/run-your-business/add-login-and-roles.md", @@ -413,7 +413,7 @@ ] }, "https://www.taskade.com/learn/genesis/build-ai-dashboard": { - "sha256": "3832d7149f681eae1f83f3f6bfc40b1c0ed6c74d266711c8b91a648749bea947", + "sha256": "1c58a88429f291a2acb498bd8085451d26978a6c0d2e40809faf71a0f4dd53c4", "pages": [ "genesis-living-system-builder/run-your-business/build-an-ops-dashboard.md" ] @@ -433,7 +433,7 @@ ] }, "https://www.taskade.com/learn/genesis/buy-domain": { - "sha256": "ad01d8e6660085666f39911f1542f1e73926fb27d689ff5d814de394e86a10dd", + "sha256": "7f77dd23a308e14b3bfa6621886d8fa68cab651a474229ccb272a18533b18df6", "pages": [ "genesis-living-system-builder/space-apps-guide/custom-domains.md" ] @@ -446,14 +446,14 @@ ] }, "https://www.taskade.com/learn/genesis/community-kits": { - "sha256": "1723d614aa5a35b0d31a7918b0487a24bd8a49ddca10cb126c0a1f3ccbcea319", + "sha256": "3644d4f30b62e7c49cd7e4319daee519197a7705a531a276c285c2a897d99f26", "pages": [ "genesis-living-system-builder/community-and-sharing/README.md", "genesis-living-system-builder/community-and-sharing/publish-and-clone.md" ] }, "https://www.taskade.com/learn/genesis/custom-domains": { - "sha256": "bee856f19ba6c49e5f332ace7825f549d30299fb409f2af466253752adb051b1", + "sha256": "ffcc884f1d8969bddcb77ae9f6220777d5e8ff60110298d349dc09a3bd90249b", "pages": [ "genesis-living-system-builder/run-your-business/from-idea-to-live-business.md", "genesis-living-system-builder/space-apps-guide/custom-domains.md" @@ -466,20 +466,20 @@ ] }, "https://www.taskade.com/learn/genesis/error-fixing": { - "sha256": "6cca2941d5d21aa210f03f508f8273eae33b2484db68dd6e1174887b96a50577", + "sha256": "3d36458f73141266b9a6b1d290fc4a23fe506523af3e7f2621a93a4140f6a316", "pages": [ "genesis-living-system-builder/community-and-sharing/troubleshooting.md", "genesis-living-system-builder/genesis/debugging-genesis-apps.md" ] }, "https://www.taskade.com/learn/genesis/faq": { - "sha256": "d7cddbc79f83edc44e354b43979dbd4150903d069326654c89adca8ec0b9841a", + "sha256": "39116f18c554cbcef6a9ba2b12cdb7d6993e5e0445dcb40ebe8003b2980999fc", "pages": [ "genesis-living-system-builder/community-and-sharing/faq.md" ] }, "https://www.taskade.com/learn/genesis/first-app": { - "sha256": "163cb6b2dfa31f8404c4dca628996333d9c9979fd6843f21d9465043f2b3a3af", + "sha256": "128b5b25a363bd5aa18ff29096867447967fdc586fde4a27379563adbf476d96", "pages": [ "genesis-living-system-builder/genesis/getting-started.md", "getting-started/README.md", @@ -512,7 +512,7 @@ ] }, "https://www.taskade.com/learn/genesis/overview": { - "sha256": "4e724c54114bba76cea1f15093f6c9286f1b27d2021c2e9af177faaa63671cf2", + "sha256": "4769ac690d8e43948bb784e8046246ed6d1cf489636da17d3992f372571a409c", "pages": [ "genesis-living-system-builder/genesis/README.md", "genesis-living-system-builder/space-apps-guide/README.md", @@ -533,7 +533,7 @@ ] }, "https://www.taskade.com/learn/genesis/publishing": { - "sha256": "d01c362d272c1abfc2ba1ffb51f4456e0164d7551f2deb7a84d8418f9f955b8b", + "sha256": "7ee3cf1bb439f04af06e9eb01afb8133d171e2729881101eed232fd25e202991", "pages": [ "genesis-living-system-builder/community-and-sharing/README.md", "genesis-living-system-builder/community-and-sharing/publish-and-clone.md", @@ -544,14 +544,14 @@ ] }, "https://www.taskade.com/learn/genesis/quickstart": { - "sha256": "1b6681265c36ce99bcd198b0189be669d96299e1fa9152191f0d083006d6f030", + "sha256": "6a804c26b22ccb13cf779103ef920110efc398adc10d3c58f520e47713dca731", "pages": [ "getting-started/README.md", "help-and-support/index/README.md" ] }, "https://www.taskade.com/learn/genesis/sell-app-kits": { - "sha256": "978f7f46c8e699c747c5d10194e1385a18b8dd8418bc14bfb3d63bdd125a6043", + "sha256": "66066e749ff42d72eb10a99bf93734d3c5da1eb7c68ae960e7d673367d78c875", "pages": [ "genesis-living-system-builder/community-and-sharing/publish-and-clone.md" ] @@ -564,7 +564,7 @@ ] }, "https://www.taskade.com/learn/genesis/troubleshooting": { - "sha256": "bfc2b4e6eaf1f1d5d9560147262a633572556bb25e501c2053f8566899d42a26", + "sha256": "5f1d9d2091adb52e25e43e5a854d939eb45dc4402c31a9a87eecbd9879f4e43f", "pages": [ "genesis-living-system-builder/community-and-sharing/troubleshooting.md", "genesis-living-system-builder/genesis/debugging-genesis-apps.md" @@ -590,14 +590,14 @@ ] }, "https://www.taskade.com/learn/genesis/workspace-dna": { - "sha256": "d28b020268fec55320e0944f0e0daa8ee63842355ec7c57748702ecaf369d7e1", + "sha256": "f403ad011d4386cfbbd85afe64bd0e146f2fdb6ea7922ed3686febaeac9479ee", "pages": [ "genesis-living-system-builder/genesis/how-genesis-works.md", "genesis-living-system-builder/genesis/workspace-dna.md" ] }, "https://www.taskade.com/learn/import/convert": { - "sha256": "344892f483de39ff84947a5079503f2da49fe94b757dc6f987b6261498588743", + "sha256": "0d2e2e2aacce7f86d9774558626070a9ef718aecaf88610267f4562cc60c7061", "pages": [ "help-center/import-and-export.md" ] @@ -639,7 +639,7 @@ ] }, "https://www.taskade.com/learn/projects/create-project": { - "sha256": "b274345cd4a60d44c312d273bacfb902b2d8d8a6441d8090e483936f622b744f", + "sha256": "d65e58b2413488fdf00049f553e7a3ca6cc3b2a6fb96a0a0f691d8298ed42293", "pages": [ "help-and-support/index/02_projects.md" ] @@ -658,7 +658,7 @@ ] }, "https://www.taskade.com/learn/projects/databases": { - "sha256": "968cb528382206cbf86ed026f38f07344140c427e670ab928615d477d8d6ce8c", + "sha256": "3d02f2bbc1417aecd40725b46bbe251bb70b0b0ba0c366eb43f5c8c9e166d258", "pages": [ "genesis-living-system-builder/workspaces/projects-databases.md", "help-and-support/index/02_projects.md" @@ -689,13 +689,13 @@ ] }, "https://www.taskade.com/learn/projects/markdown-support": { - "sha256": "b6aff1885d85a1aac274b8587fb0491fa035d039447ff2c2a5af3f9ebc834ac6", + "sha256": "a3b73c684b18db681c2cdbb8642f21e2ff791786171d09890ca66436f8796aef", "pages": [ "genesis-living-system-builder/workspaces/markdown.md" ] }, "https://www.taskade.com/learn/projects/mobile-guide": { - "sha256": "92e06f6c95814c5867df09049c44b1e98d2f571009a981afdbb86b893ee179c2", + "sha256": "d762b83fa59c039cc8729b6c95dc658e09926da9ce08037f6498a2d0d1cfb476", "pages": [ "genesis-living-system-builder/workspaces/mobile-optimization.md", "help-and-support/index/08_mobile_desktop.md", @@ -716,26 +716,26 @@ ] }, "https://www.taskade.com/learn/projects/project-views": { - "sha256": "3c22cb58b5ffd611edef57aaa99aae847a296d76c24d70a92d213ab1d50b8f13", + "sha256": "926a9a4c6e88809ae3985e77e72bbc79f2e5d0ae1aa29ca4e2597a323f6ec549", "pages": [ "genesis-living-system-builder/workspaces/project-views.md", "help-and-support/index/02_projects.md" ] }, "https://www.taskade.com/learn/projects/search": { - "sha256": "0cd26c77f7d33d8dc59f3b0d0b384821215e056058cbe4741a57db69f6a84f06", + "sha256": "6dfbfd63f4811dbb9b92e621f534a220bb7610391c08a4f42883171652c3b897", "pages": [ "genesis-living-system-builder/workspaces/advanced-search-navigation.md" ] }, "https://www.taskade.com/learn/projects/slash-commands": { - "sha256": "db65f675617d2384829a08414f0fd196009fdd52b25ceaa63f8532f01968d530", + "sha256": "bd3d40c5e16481b377783a8066928b4fc756cfa32c68e522705f247127fdeba6", "pages": [ "genesis-living-system-builder/workspaces/editing-formatting.md" ] }, "https://www.taskade.com/learn/projects/start-here": { - "sha256": "cf4b7f5c4639b6823a30a66cf33528dd5a0034735f13758cc46a8e55c0adba31", + "sha256": "e923ef460c3d0d6d4b011e1e59e7b525708d4d65a2c4cd54e696e6f94c167608", "pages": [ "help-and-support/index/README.md" ] diff --git a/account-management/README.md b/account-management/README.md index ca850f6..7decb6b 100644 --- a/account-management/README.md +++ b/account-management/README.md @@ -58,21 +58,23 @@ Settings > Members > click the **✕** icon next to the member. | Plan | Price | AI Credits/mo | |------|-------|--------------| | **Free** | $0 | 0 (earn credits with referrals and invites) | -| **Starter** | $6/mo, billed annually | 10,000 | +| **Starter** | $6/mo, billed annually (yearly only) | 10,000 | | **Pro** | $10/mo billed annually, or $20 monthly | 50,000 | | **Business** | $25/mo billed annually, or $50 monthly | 150,000 | | **Max** | $100/mo billed annually, or $200 monthly | 400,000 | -| **Enterprise** | Custom (contact sales) | Custom | +| **Enterprise** | $250/mo billed annually, or $500 monthly (contact sales) | 1,100,000 | Key features of each plan: -- **Free**: 2 members, 3 Taskade Genesis apps, 1 AI agent, 10 automation runs a month. +- **Free**: 2 members, 3 Taskade Genesis apps, 1 AI agent, 10 automation runs a billing period. - **Starter**: 3 members, unlimited apps, premium integrations, hosted MCP access. - **Pro**: 10 members, custom domains (up to 10), webhooks, your own AI key (BYOK), app bundle export. - **Business**: Unlimited members, unlimited custom domains, SSO/SAML, app analytics, custom branding. -- **Max**: Everything in Business, with higher AI limits. +- **Max**: Everything in Business, with higher AI limits. Business allows 80,000 AI requests a day, and Max allows 320,000. - **Enterprise**: Everything in Max, plus SCIM provisioning and the highest AI limits. +Automation runs a billing period are 10 on Free, 350 on Starter, 1,000 on Pro, and 10,000 on Business and up. The whole workspace shares the Monthly Credits and the automation runs. The table shows the base level of each plan. A higher **credits / month** level on the upgrade page raises both. + Full details: [taskade.com/pricing](https://www.taskade.com/pricing) ### Manage Your Subscription diff --git a/account-management/credits-and-billing.md b/account-management/credits-and-billing.md index c7f808c..4a0a022 100644 --- a/account-management/credits-and-billing.md +++ b/account-management/credits-and-billing.md @@ -9,11 +9,11 @@ description: >- ## How AI Credits Work -Every AI request in Taskade — prompting an agent, running an automation with AI, generating a Taskade Genesis app — consumes credits. The credit cost depends on the model: +Each AI request in Taskade uses credits. An AI request can be a prompt to an agent, an AI step in an automation, or the build of a Taskade Genesis app. The credit cost depends on the model: -* **Lightweight models** cost fewer credits per request. -* **Frontier models** (top-tier reasoning models) cost more. -* **Auto mode** picks a model for each request, so you don't need to pick the right model for each task by hand. Auto is the default. +* **Lightweight models** cost fewer credits for each request. +* **Frontier models** (the models with the deepest reasoning) cost more. +* **Auto mode** picks a model for each request, so you do not pick a model for each task. Auto is the default. *** @@ -21,18 +21,18 @@ Every AI request in Taskade — prompting an agent, running an automation with A A Free workspace starts with 0 AI credits. On Free, you earn free AI credits with referrals and invites, and you can upgrade any time. -* **Referrals:** you earn credits when someone signs up for Taskade through your referral link and verifies their email, up to a limit. Find your link in [Settings → Earn credits](https://www.taskade.com/settings/credits). -* **Paid plans:** every paid plan includes a monthly AI credit allowance. See the [plan table](README.md#current-plans). +* **Referrals:** You earn credits when a person signs up for Taskade through your referral link and verifies their email, up to a limit. Your link is in [Settings → Earn credits](https://www.taskade.com/settings/credits). +* **Paid plans:** Each paid plan includes a monthly AI credit allowance. See the [plan table](README.md#current-plans). {% hint style="info" %} -Check the [pricing page](https://www.taskade.com/pricing) for the current plans. +The current plans are on the [pricing page](https://www.taskade.com/pricing). {% endhint %} *** ## Paid Plan Credits -Paid plans include monthly premium credits that reset on your billing cycle. +Paid plans include Monthly Credits. Monthly Credits reset on each billing cycle. | Plan tier | Monthly credits | Key benefit | | ---------- | ---------------------------------------------------------- | ----------------------------- | @@ -40,104 +40,113 @@ Paid plans include monthly premium credits that reset on your billing cycle. | Pro | 50,000 | Personal productivity | | Business | 150,000 | Team use, complex AI tasks | | Max | 400,000 | Heavy generation, large teams | -| Enterprise | Custom allowance + admin controls | Organization-wide deployments | +| Enterprise | 1,100,000 | Organization-wide deployments | {% hint style="info" %} -Exact credit amounts per tier may change. See the [pricing page](https://www.taskade.com/pricing) for current allocations. +The credit amounts for each tier can change. The [pricing page](https://www.taskade.com/pricing) shows the current amounts. {% endhint %} -Max and Enterprise plans get refined credit limits designed for bursty workloads — you won't get throttled mid-task during a heavy generation run. +Max and Enterprise plans have credit limits for large bursts of work. Taskade does not stop these plans in the middle of a large build. *** ## What Your App Will Cost -If you're building and running a real app on Genesis, the question isn't "how many credits does one request cost" — it's "what in my app burns credits, and how much will it burn as I grow." Use this as a decision guide. For exact, current per-request numbers, always check the in-app model picker; published figures drift as models and pricing change. +If you build and operate an app on Taskade Genesis, the important question is which parts of the app use credits. The second question is how that use grows with your app. Use this section to decide on a plan. For the current cost of each request, look at the model picker in the app. Published numbers change when models and prices change. -### What drives your credit use +### What uses your credits -| What consumes credits | What drives the cost (relative) | +| What uses credits | What changes the cost | | ------------------------------------ | -------------------------------------------------------------------------------------------------------------------- | -| **Genesis app generation & iteration** | Heaviest up front, while you build. Each generate and each "edit with AI" pass costs credits; settles down once the app is stable. | -| **AI automation steps** | Scales with how often your automations run and how many AI steps each run includes. A trigger that fires all day costs more than one that fires occasionally. | -| **An agent answering end-users** | Scales with the number of people using your published app and how chatty each session is. This is the line item that grows as your app gets traffic. | -| **Agent / Taskade EVE chat** | Scales with how much you and your team use AI assistance day to day — drafting, summarizing, asking questions in your workspace. | +| **Taskade Genesis app builds and edits** | The largest cost comes at the start, while you build. Each build and each "edit with AI" pass uses credits. The cost decreases when the app is stable. | +| **AI automation steps** | The cost grows with the number of runs and the number of AI steps in each run. A trigger that fires all day costs more than a trigger that fires once a week. | +| **An agent that answers your app users** | The cost grows with the number of people who use your published app and the length of each chat. This cost grows as your app gets more traffic. | +| **Agent and Taskade EVE chat** | The cost grows with the AI help that you and your team use each day: drafts, summaries, and questions in your workspace. | -Steps that don't call AI — plain forms, stored data, non-AI automation actions — don't draw from your credit balance. +Steps that do not call AI use no credits. Examples are plain forms, stored data, and automation actions with no AI. -### Right-size it +### Pick the right plan -* **Low usage** — You're building for yourself or a small team, with light traffic and occasional automations. A personal paid tier (Pro direction) is usually enough; top up with a credit pack during a build sprint. -* **Medium usage** — A team relies on the app, automations run regularly, and a handful of end-users hit your agent daily. Lean toward the Business tier. -* **High usage** — A public-facing app with steady traffic, an agent answering many end-users, and automations firing throughout the day. Lean toward Max or Enterprise, which are tuned for bursty, high-volume AI workloads without mid-task throttling. +* **Low use:** You build for yourself or a small team. Traffic is light and automations run once in a while. A personal paid tier, such as Pro, is usually enough. Buy a credit pack for a large build. +* **Medium use:** A team relies on the app, automations run regularly, and some app users talk to your agent each day. The Business tier is a good fit. +* **High use:** A public app has steady traffic, an agent answers many app users, and automations run all day. Max or Enterprise is a good fit. These plans have limits for large bursts of AI work. -Don't over-buy on day one. Watch your [usage page](credits-and-billing.md#viewing-your-usage) for the first month, then size to what your app actually draws. +Do not buy too much on the first day. Watch your [usage page](credits-and-billing.md#viewing-your-usage) for one month. Then pick the plan that matches the credits that your app uses. -### Keep your app from running dry +### Keep your app running -If real customers use your published app, an agent that runs out of credits mid-session is the worst time to find out. Turn on [**Auto Top-Up**](credits-and-billing.md#auto-top-up) so your balance refills automatically before it hits zero — your customer-facing agent keeps answering instead of stalling on an out-of-credits screen. +If customers use your published app, an agent with no credits stops in the middle of a chat. Turn on [**Auto Top-Up**](credits-and-billing.md#auto-top-up) to refill your balance before it gets to zero. Then your agent continues to answer your customers. *** ## Credit Packs -Credit packs are one-time purchases on top of your monthly allocation. +A credit pack is a one-time purchase. It adds credits to your monthly allowance. -* **Volume-tiered pricing** — bigger packs come with bigger bonuses. -* **Purchased credits never expire** — top up once, use over time. Taskade uses your Monthly Credits first, then these Extra Credits. -* Purchases appear in the workspace activity log for audit visibility. +* **Prices by volume:** A larger pack gives a larger bonus. +* **No expiry:** Purchased credits do not expire. Taskade uses your Monthly Credits first, then these Extra Credits. +* **Audit record:** Each purchase shows in the workspace activity log.
-Use packs when you expect a heavy AI month — during a product launch, a big content sprint, or a large Genesis app build. +A pack is useful for a month with a lot of AI work, for example a product launch, a large content project, or a large Taskade Genesis app build. *** ## Auto Top-Up -Auto Top-Up prevents you from running out of credits in the middle of a workflow. +Auto Top-Up buys credits for you before your balance runs out in the middle of a workflow. ### How It Works -1. Set a **balance threshold** (the default is 9,000 credits). -2. Set a **top-up amount** in dollars (the default is $20). -3. When your balance drops below the threshold, or gets too low for the next AI step, Taskade automatically buys a credit pack with your saved card. +1. Set a **balance threshold**. The default is 9,000 credits. +2. Set a **top-up amount** in dollars. The default is $20. +3. Taskade buys a credit pack with your saved card when your balance drops below the threshold. It also buys a pack when the balance is too low for the next AI step. -### Setting It Up +### Turn On Auto Top-Up 1. Open [Settings → Credits](https://www.taskade.com/settings/usage) in a web browser. -2. Find the **Auto-reload** row on the **Credits** card and turn the switch on. -3. To change the amounts, click **Manage**, then **Change settings**. -4. Pick the **Top up amount** and the **When credit balance drops below** value, then click **Save changes**. +2. Find the **Auto-reload** row on the **Credits** card. +3. Turn on the switch. +4. To change the amounts, click **Manage**, then **Change settings**. +5. Pick the **Top up amount** and the **When credit balance drops below** value. +6. Click **Save changes**.
{% hint style="warning" %} -Auto Top-Up charges your payment method automatically when triggered. Set a reasonable threshold and top-up amount to match your expected usage. +Set a threshold and a top-up amount that match your usual use. Auto Top-Up charges your card each time it buys a pack. {% endhint %} -Auto Top-Up is available on every paid plan. The mobile apps and the app-store desktop apps hide this control. +Auto Top-Up is available on every paid plan. The mobile apps and the app-store desktop apps do not show this control. *** ## Model-Specific Pricing -Each AI model has its own credit cost per request. Pricing is adjusted periodically to track provider costs. +Each AI model has its own credit cost for each request. Taskade changes these prices from time to time to match the costs of the providers. -* You can see the current per-model credit cost in the model picker before selecting a model. +* The model picker shows the current credit cost of each model before you select it. * Auto mode picks a model for each request. -* For the authoritative current list, check the in-app model picker. +* The model picker in the app always has the current list. *** ## Viewing Your Usage -Taskade surfaces credit usage in several places. +Taskade shows your credit use in these places: -* **Usage page** in your account settings shows monthly credit consumption. -* **Workspace activity log** records every credit pack purchase. -* **Per-agent usage analytics** show which agents consume the most credits. -* **Automation run reports** show credits used per run. +* **Usage page:** Your account settings show the credits that you used this month. +* **Workspace activity log:** The log records each credit pack purchase. +* **Usage for each agent:** The analytics show which agents use the most credits. +* **Automation run reports:** Each report shows the credits that one run used. + +To see what used your credits: + +1. Open [Settings → Credits](https://www.taskade.com/settings/usage). +2. Expand **Usage this month**. +3. Read the **Where your credits went** list. It shows the credits of the last 30 days by source: **Taskade EVE builds and edits**, **Agents**, **Automations**, and **Other (files, voice, images)**. Only the person who pays for a paid plan sees it. +4. To see each day and each model, click **See where credits went**.
@@ -145,18 +154,18 @@ Taskade surfaces credit usage in several places. ## What Happens When You Run Out -Taskade never silently fails an AI request due to insufficient credits. +Taskade always tells you when an AI request stops because of low credits. -* **Paid users**: You're routed to the upgrade or credit-pack screen. -* **Free users**: You're prompted to upgrade. -* **Out-of-credits error** surfaces cleanly in the UI — no mysterious silent drops. +* **Paid users:** Taskade opens the upgrade screen or the credit pack screen. +* **Free users:** Taskade asks you to upgrade. +* **Clear message:** The out-of-credits error shows in the app. A request does not stop without a message. {% hint style="info" %} -Public agent visitors never see internal billing errors. If your app's agent runs out of credits, external users see a neutral error message, not billing details. +Visitors of a public agent never see billing errors. If the agent of your app runs out of credits, visitors see a neutral error message with no billing details. {% endhint %} {% hint style="info" %} -Building against the API? See the [REST API guide](../apis-living-system-development/comprehensive-api-guide/README.md) for rate limits and error-handling conventions when requests fail. +If you build with the API, read the [REST API guide](../apis-living-system-development/comprehensive-api-guide/README.md). It gives the rate limits and the error codes for a request that fails. {% endhint %} *** @@ -167,7 +176,7 @@ Building against the API? See the [REST API guide](../apis-living-system-develop Do credits expire? -On paid plans, purchased credit packs don't expire. Monthly premium credits reset each billing cycle. A Free workspace has no monthly allowance — check the pricing page for current policy. +On paid plans, purchased credit packs do not expire. Monthly Credits reset each billing cycle. A Free workspace has no monthly allowance. The pricing page shows the current policy. @@ -175,7 +184,7 @@ On paid plans, purchased credit packs don't expire. Monthly premium credits rese Can I refund unused credits? -Refund policies vary. Contact support for case-by-case review. +Refund policies are different for each case. Contact support for a review of your case. @@ -183,7 +192,7 @@ Refund policies vary. Contact support for case-by-case review. Does Auto Top-Up have a spending cap? -Yes. Auto Top-Up buys at most 5 times in 24 hours. If you set a monthly spend limit, it stops for the rest of the month at that limit. Monitor your usage page during the first month to tune the settings. +Yes. Auto Top-Up buys a maximum of 5 times in 24 hours. If you set a monthly spend limit, Auto Top-Up stops for the rest of the month at that limit. Watch your usage page in the first month, and then adjust the settings. @@ -191,15 +200,15 @@ Yes. Auto Top-Up buys at most 5 times in 24 hours. If you set a monthly spend li Which models use the fewest credits? -Lightweight models have the lowest per-request cost. The model picker shows current pricing for each available model. +Lightweight models have the lowest cost for each request. The model picker shows the current price of each model.
-Does a Genesis app clone cost me credits? +Does a Taskade Genesis app clone cost me credits? -Cloning a Genesis app does not consume credits on its own. AI usage inside the cloned app consumes credits normally. +A clone of a Taskade Genesis app uses no credits. AI use inside the cloned app uses credits as usual.
diff --git a/apis-living-system-development/agent-embeds.md b/apis-living-system-development/agent-embeds.md index 595ca61..2ffaa14 100644 --- a/apis-living-system-development/agent-embeds.md +++ b/apis-living-system-development/agent-embeds.md @@ -5,27 +5,27 @@ description: >- # Embed a Public AI Agent -Add a public Taskade AI agent to your website with an iframe or a chat widget. You publish the agent, copy the code from **Publish** → **Embed**, and paste the code into your page. +You can put a public Taskade AI agent on your website as an iframe or as a chat widget. Publish the agent, copy the code from **Publish** → **Embed**, and paste the code into your page. ## Before you start -You need an AI agent and edit access to your website's HTML. +You must have these items: -- **An AI agent in your workspace.** Publishing and embedding are on every plan. -- **Access to your site's HTML.** You paste one ` ``` -Copy the snippet from the Share panel rather than hand-writing it — the builder fills in the correct URL for your agent (including custom domains). +Copy the snippet from the Share panel. Do not write it by hand. The builder adds the correct URL for your agent, custom domains included. ### **Use Cases** -**Customer Support:** +**Customer support:** -* Embed support agents on your website -* Provide 24/7 assistance with your product knowledge -* Handle common questions automatically +* Put support agents on your website. +* Answer questions at all hours with your product knowledge. +* Answer common questions automatically. -**Lead Generation:** +**Lead generation:** -* Qualification agents that assess potential clients -* Interactive consultations that capture contact info -* Product recommendation engines +* Use agents that qualify possible clients. +* Hold interactive consultations that collect contact details. +* Recommend products. -**Education & Training:** +**Education and training:** -* Subject matter experts embedded in courses -* Interactive tutors for complex topics -* Assessment and feedback systems +* Put subject experts into courses. +* Give interactive tutors for complex topics. +* Give assessments and feedback. ### **Professional Integration** -* **Seamless Branding**: Agents match your website's design -* **Custom Domains**: Host agents on your own domain -* **Analytics Tracking**: Monitor conversations and effectiveness -* **Lead Capture**: Automatically collect user information +* **Branding**: Agents match the design of your website. +* **Custom domains**: Agents can run on your own domain. +* **Analytics**: Track conversations and results. +* **Lead capture**: Agents collect user information automatically. *** @@ -250,43 +265,45 @@ Copy the snippet from the Share panel rather than hand-writing it — the builde ### Step 1: Prepare Your App -Before sharing, ensure your app is ready for public use: +Prepare your app for public use before you share it. -**Content Review:** +**Content review:** -* Remove any sensitive data, API keys, or personal information -* Use generic example data that demonstrates functionality -* Ensure all text is professional and helpful -* Test all features work correctly +* Remove sensitive data, API keys, and personal information. +* Use general example data that shows the functions. +* Make sure that all text is professional and helpful. +* Test all features. **Documentation:** -* Add clear descriptions of what the app does -* Include setup instructions if integrations are needed -* Provide example use cases and benefits -* Consider adding a brief "how it works" explanation +* Add a clear description of what the app does. +* Add setup steps if the app needs integrations. +* Give example use cases and benefits. +* Add a short "how it works" explanation. ### Step 2: Publish to Community -1. **Open your Genesis app** in your workspace and publish it (a draft cannot be shared) -2. **Click Publish** in the top toolbar -3. **Under More options, turn on "Show in public listings"** -4. **To let people copy it, open "Let others clone"** and choose **Free** or **Paid** (this also turns on the public listing) -5. **Give the app a clear name and description**: Taskade sorts the listing into a category for you +1. Open your Taskade Genesis app in your workspace and publish it. You cannot share a draft. +2. Click **Publish** in the top toolbar. +3. Under **More options**, turn on **Show in public listings**. +4. To let people copy the app, open **Let others clone** and choose **Free** or **Paid**. This also turns on the public listing. +5. Give the app a clear name and description. Taskade puts the listing into a category for you. + +After you publish an app that you built, the dialog that says your app is live can show **Share as a free template in the app gallery**. Click **Add** to do the same as **Let others clone** set to **Free**. ### Step 3: Manage Your Community App -**Track Performance:** +**Track performance:** -* View views, likes, and clone (install) counts -* See your app's intelligence score -* Monitor visitors with App Analytics (Business and up) +* See the counts of views, likes, and clones (installs). +* See the intelligence score of your app. +* Track visitors with App Analytics (Business and up). -**Keep It Updated:** +**Keep the app up to date:** -* Regular updates improve discoverability -* Fix issues reported by community users -* Add new features based on feedback +* Regular updates help people find your app. +* Correct the problems that community users report. +* Add new features from their feedback. *** @@ -294,18 +311,18 @@ Before sharing, ensure your app is ready for public use: ### What is App Forking? -Forking creates a complete, independent copy of a Genesis app in your workspace. You get everything: projects, AI agents, automations, media files, and configurations—all ready to use and customize. +A fork is a complete, independent copy of a Taskade Genesis app in your workspace. You get the projects, AI agents, automations, media files, and settings. You can use and change all of them. ### Finding Apps to Fork -**Browse the Community Marketplace:** +**Browse the community marketplace:** -* **By Category**: Business tools, customer service, e-commerce, etc. -* **By Popularity**: Most forked, highest rated, recently updated -* **By Industry**: Restaurants, healthcare, consulting, retail, etc. -* **By Features**: File uploads, payment processing, automation complexity +* **By category**: business tools, customer service, online stores, and more +* **By popularity**: most forked, highest rated, recently updated +* **By industry**: restaurants, healthcare, consulting, retail, and more +* **By features**: file uploads, payments, and automation complexity -**Search and Filter:** +**Search and filter:** ``` Search: "customer feedback restaurant" @@ -314,45 +331,63 @@ Browse: categories such as Dashboards, CRMs, Websites, and Forms ### How to Fork an App -1. **Find the app** you want at [taskade.com/apps](https://www.taskade.com/apps) -2. **Click "Preview"** to test functionality and see what it does -3. **Open "Workspace"** to review the projects, agents, and automations it includes -4. **Click "Clone"** (shown only when the creator offers the app as a kit) -5. **Choose destination workspace** (if you have multiple) -6. **Wait 30-60 seconds** for the complete copy process -7. **Your forked app appears** in your workspace, fully functional +1. Find the app that you want at [taskade.com/apps](https://www.taskade.com/apps). +2. Click **Preview** to try the app. +3. Open **Workspace** to see the projects, agents, and automations in the app. +4. Click **Clone**. This button shows only when the creator offers the app as a kit. +5. If you have more than one workspace, choose the destination workspace. +6. Wait 30 to 60 seconds while Taskade copies the app. + +Your forked app then shows in your workspace, and it works. + +A creator can archive a kit or the workspace behind it. Taskade can also take a kit down. In both cases, the kit page says that the app is no longer available, and it has no **Clone** button. A person who bought a paid kit can still clone it. A copy that you cloned before stays in your workspace. ### What You Get When Forking -**Complete Workspace Copy:** +**Full copy of the workspace parts:** -* **All Projects**: Data structures, custom fields, templates -* **AI Agents**: Trained agents with their knowledge and personalities -* **Automations**: Workflows and triggers. Connect your own third-party accounts, because connected accounts and secrets are not copied -* **Media Files**: Images, documents, logos, and assets -* **Configurations**: Settings, permissions, and customizations +* **All projects**: data structures, custom fields, and templates +* **AI agents**: trained agents with their knowledge and personalities +* **Automations**: workflows and triggers. Connect your own third-party accounts, because Taskade does not copy connected accounts and secrets. +* **Media files**: images, documents, logos, and assets +* **Settings**: permissions and customizations **Independence:** -* Your fork is completely separate from the original -* Make any changes without affecting the source app -* Update, rebrand, or modify freely -* No ongoing connection to the original creator +* Your fork is separate from the original. +* Your changes do not change the source app. +* You can update, rebrand, or change the fork. +* Your fork has no connection to the original creator. *** ## Fork vs. Template vs. Clone -Understanding the differences helps you choose the right approach: +Each approach gives a different result. + +**Fork** (a copy of a community app): + +* Content: the complete set of workspace parts +* Data: example data included +* Agents: fully trained +* Automations: workflows. Connect your own accounts +* Changes: you can edit everything + +**Template** (a Taskade template): -| Feature | Fork | Template | Clone | -| ----------------- | --------------------- | ------------------- | --------------------- | -| **Source** | Community apps | Taskade templates | Your own apps | -| **Content** | Complete workspace | Structure only | Exact copy | -| **Data** | Example data included | Empty/placeholder | Your actual data | -| **Agents** | Fully trained | Basic setup | Identical training | -| **Automations** | Workflows (reconnect your accounts) | Framework only | All your integrations | -| **Customization** | Fully editable | Highly customizable | Identical copy | +* Content: the structure only +* Data: empty or placeholder data +* Agents: a basic setup +* Automations: a framework only +* Changes: you can change a lot + +**Clone** (a copy of your own app): + +* Content: an exact copy +* Data: your real data +* Agents: the same training +* Automations: all your integrations +* Changes: the copy starts identical to your app *** @@ -360,7 +395,7 @@ Understanding the differences helps you choose the right approach: ### Creating Shareable Apps -**Design for Reusability:** +**Design your app for reuse:** ``` ❌ "Sarah's Restaurant Feedback System" @@ -373,16 +408,16 @@ Understanding the differences helps you choose the right approach: ✅ Simple setup with clear documentation ``` -**Include Complete Examples:** +**Include complete examples:** -* Sample data that demonstrates all features -* Example automations that work out of the box -* Clear naming conventions that make sense to outsiders -* Help text and tooltips explaining business logic +* Sample data that shows all features +* Example automations that work by default +* Clear names that make sense to other people +* Help text and tooltips that explain the business rules ### Writing Great Descriptions -**Be Specific About Value:** +**Say what value the app gives:** ``` ❌ "Helps with customer stuff" @@ -392,7 +427,7 @@ Understanding the differences helps you choose the right approach: ✅ "Perfect for restaurants, cafes, food trucks, and any food service business wanting to improve customer satisfaction" ``` -**Include Setup Requirements:** +**Give the setup requirements:** ``` "This app works immediately after forking, but for full functionality you'll need: @@ -403,19 +438,19 @@ Understanding the differences helps you choose the right approach: ### Optimizing for Discovery -**Choose Effective Tags:** +**Choose good tags:** -* **Business Function**: "feedback", "booking", "inventory", "crm" +* **Business function**: "feedback", "booking", "inventory", "crm" * **Industry**: "restaurant", "healthcare", "consulting", "retail" * **Features**: "mobile-friendly", "payments", "automation", "reporting" -* **Skill Level**: "beginner", "intermediate", "advanced" +* **Skill level**: "beginner", "intermediate", "advanced" -**Update Regularly:** +**Update regularly:** -* Fix bugs reported by community users -* Add requested features when possible -* Keep screenshots current with any UI changes -* Respond to comments and questions +* Correct the bugs that community users report. +* Add requested features. +* Keep screenshots current after UI changes. +* Answer comments and questions. *** @@ -423,31 +458,31 @@ Understanding the differences helps you choose the right approach: ### Customer Experience -* **Feedback Collection**: Rating systems, review management -* **Support Portals**: Ticket systems, knowledge bases -* **Booking Systems**: Appointments, reservations, scheduling -* **Onboarding Flows**: Welcome sequences, setup wizards +* **Feedback collection**: rating systems and review management +* **Support portals**: ticket systems and knowledge bases +* **Booking systems**: appointments, reservations, and schedules +* **Onboarding flows**: welcome sequences and setup wizards ### Business Operations -* **Inventory Management**: Stock tracking, reorder alerts -* **Lead Management**: Sales pipelines, follow-up systems -* **Employee Tools**: Onboarding, performance tracking -* **Financial Tracking**: Expense reports, budget monitoring +* **Inventory management**: stock tracking and reorder alerts +* **Lead management**: sales pipelines and follow-up systems +* **Employee tools**: onboarding and performance tracking +* **Financial tracking**: expense reports and budget tracking ### Content & Marketing -* **Content Calendars**: Social media planning, publication schedules -* **Campaign Tracking**: Marketing performance, ROI analysis -* **Brand Management**: Asset libraries, style guide compliance -* **Event Management**: Registration, attendee tracking +* **Content calendars**: social media plans and publication schedules +* **Campaign tracking**: marketing performance and ROI analysis +* **Brand management**: asset libraries and style guide rules +* **Event management**: registration and attendee tracking ### Industry-Specific Solutions -* **Restaurant**: Menu management, table reservations, staff scheduling -* **Healthcare**: Patient intake, appointment reminders, billing -* **Real Estate**: Property listings, client management, tour scheduling -* **Education**: Course management, student tracking, assignment submission +* **Restaurant**: menu management, table reservations, and staff schedules +* **Healthcare**: patient intake, appointment reminders, and billing +* **Real estate**: property listings, client management, and tour schedules +* **Education**: course management, student tracking, and assignment submission *** @@ -455,35 +490,35 @@ Understanding the differences helps you choose the right approach: ### Before Publishing -**Data Sanitization:** +**Clean the data:** -* Remove all real customer data and replace with examples -* Clear any API keys, passwords, or credentials -* Scrub email addresses, phone numbers, and personal information -* Review all text fields for sensitive business information +* Remove all real customer data, and put in examples. +* Remove API keys, passwords, and credentials. +* Remove email addresses, phone numbers, and personal information. +* Read all text fields for sensitive business information. -**Access Control Review:** +**Examine access control:** -* Ensure no private integrations remain connected -* Remove any workspace-specific permissions -* Clear personalized settings and preferences -* Test with a fresh account to verify clean state +* Make sure that no private integrations stay connected. +* Remove workspace-specific permissions. +* Clear personal settings and preferences. +* Test with a new account to make sure that the app is clean. ### Community Guidelines -**Prohibited Content:** +**Prohibited content:** -* Apps containing real personal or business data +* Apps that contain real personal or business data * Malicious code or security exploits -* Copyright-infringing content or branding +* Content or branding that breaks copyright * Spam or low-quality submissions -**Best Practices:** +**Best practices:** -* Use placeholder data that clearly demonstrates functionality -* Include proper attribution for any third-party resources -* Respect intellectual property and create original solutions -* Provide honest, accurate descriptions of capabilities +* Use placeholder data that shows the functions clearly. +* Give credit for third-party resources. +* Respect intellectual property, and make original solutions. +* Give honest and correct descriptions of what the app does. *** @@ -491,34 +526,34 @@ Understanding the differences helps you choose the right approach: ### Community App Metrics -**Core Statistics:** +**Core statistics:** -* **Install Count**: How many users have cloned your app -* **View Count**: Total views of your listing -* **Like Count**: How many people liked your app -* **Intelligence Score**: How complete your app's Workspace DNA is +* **Install count**: how many users cloned your app +* **View count**: total views of your listing +* **Like count**: how many people liked your app +* **Intelligence score**: how complete the Workspace DNA of your app is -**Performance Insights:** +**Performance insights:** * **App Analytics** (Business and up): visitors, pageviews, top pages, referrers, devices, and locations -* **User Feedback**: Common questions and requests -* **Update Impact**: How changes affect usage metrics +* **User feedback**: common questions and requests +* **Update impact**: how your changes affect usage ### Growing Your Community Presence -**Engagement Strategies:** +**Engagement:** -* **Respond to Questions**: Help the people who clone your app -* **Regular Updates**: Keep apps current with new features -* **Cross-Promotion**: Reference your apps in forum discussions -* **Documentation**: Create helpful guides and tutorials +* **Answer questions**: help the people who clone your app. +* **Update regularly**: add new features to your apps. +* **Cross-promotion**: mention your apps in forum discussions. +* **Documentation**: write helpful guides and tutorials. -**Building Reputation:** +**Reputation:** -* **Quality Over Quantity**: Focus on polished, useful apps -* **User Support**: Help community members succeed with your apps -* **Innovation**: Pioneer new solutions and approaches -* **Collaboration**: Work with other community builders +* **Quality over quantity**: build finished, useful apps. +* **User support**: help community members use your apps. +* **New ideas**: build new kinds of solutions. +* **Collaboration**: work with other community builders. *** @@ -526,7 +561,7 @@ Understanding the differences helps you choose the right approach: ### Embedding Community Apps -A published community app is a standard Taskade Genesis app, so you can embed it in any web page with an ` ``` -Copy the exact snippet with **Copy Embed Code** in the app's **Publish** panel. +Copy the exact snippet with **Copy Embed Code** in the **Publish** panel of the app. ### API Integration with Community Apps -Apps you clone from the community are standard Genesis apps. Build integrations with the [public API](../../apis-living-system-development/developer-home.md), and have an app call external services securely through the [App Secrets](../space-apps-guide/app-secrets.md) outbound proxy — there is no separate `community` API surface. +An app that you clone from the community is a standard Taskade Genesis app. Build integrations with the [public API](../../apis-living-system-development/developer-home.md). An app can call external services securely through the [App Secrets](../space-apps-guide/app-secrets.md) outbound proxy. There is no separate `community` API surface. ### Collaborative Development -**Community Feedback Integration:** +**Community feedback:** -* Feature request voting systems +* Feature request votes * Bug report tracking -* Collaborative improvement suggestions -* Community-driven documentation +* Shared improvement ideas +* Documentation that the community writes *** @@ -558,35 +593,35 @@ Apps you clone from the community are standard Genesis apps. Build integrations ### Publishing Problems -**Issue**: App won't publish to community **Solutions**: +**Problem**: The app does not publish to the community. **Solutions**: -* Ensure all sensitive data is removed -* Verify app is in a published state (not draft) -* Only the workspace owner can share an app as a kit -* Review content guidelines compliance +* Remove all sensitive data. +* Make sure that the app is published, not a draft. +* Ask the workspace owner to share the app as a kit. Only the workspace owner can do this. +* Read the content guidelines and obey them. -**Issue**: Low discovery/fork rate **Solutions**: +**Problem**: Few people find or fork the app. **Solutions**: -* Improve app description with specific benefits -* Add better screenshots and preview content -* Choose more effective tags and categories -* Respond to user reviews and questions +* Give specific benefits in the app description. +* Add better screenshots and preview content. +* Choose better tags and categories. +* Answer user reviews and questions. ### Forking Problems -**Issue**: Forked app doesn't work properly **Solutions**: +**Problem**: The forked app does not work correctly. **Solutions**: -* Check if original app requires specific integrations -* Review setup instructions provided by creator -* Ensure all media files transferred correctly -* Contact app creator for support +* Find out if the original app needs specific integrations. +* Read the setup steps from the creator. +* Make sure that all media files arrived. +* Contact the app creator for help. -**Issue**: Can't customize forked app **Solutions**: +**Problem**: You cannot change the forked app. **Solutions**: -* Verify you have full ownership of the forked copy -* Check workspace permissions and roles -* Ensure you're editing the fork, not viewing the original -* Contact Taskade support if restrictions seem incorrect +* Make sure that you own the forked copy. +* Examine the workspace permissions and roles. +* Make sure that you edit the fork, not the original. +* If the limits look wrong, contact Taskade support. *** @@ -594,53 +629,51 @@ Apps you clone from the community are standard Genesis apps. Build integrations ### Community Documentation -* [**Community Guidelines**](https://www.taskade.com/learn/genesis/community-gallery) - Rules and best practices -* [**Publishing Checklist**](https://www.taskade.com/learn/genesis/publishing) - Pre-publication review steps -* [**Community Success Tips**](https://www.taskade.com/learn/genesis/community-kits) - Growing your presence +* [**Community Guidelines**](https://www.taskade.com/learn/genesis/community-gallery): rules and best practices +* [**Publishing Checklist**](https://www.taskade.com/learn/genesis/publishing): review steps before you publish +* [**Community Success Tips**](https://www.taskade.com/learn/genesis/community-kits): grow your presence ### Getting Help -* **Community Forum**: Connect with other builders and users -* **Creator Support**: Special support channel for active community contributors -* **Documentation Requests**: Help improve community resources -* **Bug Reports**: Report issues with community features +* **Community forum**: talk with other builders and users. +* **Creator support**: a support channel for active community creators. +* **Documentation requests**: help improve the community resources. +* **Bug reports**: report problems with community features. ### Learning Resources -* **Community Showcase**: Featured apps and case studies -* **Builder Interviews**: Learn from successful community creators -* **Best Practice Guides**: Detailed tutorials and examples -* **Video Walkthroughs**: Step-by-step creation and publishing guides +* **Community showcase**: featured apps and case studies +* **Builder interviews**: lessons from successful community creators +* **Best practice guides**: detailed tutorials and examples +* **Video walkthroughs**: step-by-step build and publish guides *** ## Ready to Share Your Genius? -The Taskade community is waiting to discover your innovative solutions. Whether you've built the perfect customer feedback system, an ingenious inventory tracker, or a game-changing team dashboard, sharing it helps teams worldwide while establishing your expertise. +Share your feedback system, inventory tracker, or team dashboard with the Taskade community. Your app helps other teams, and it shows your skills. ### Quick Start Checklist -* [ ] **Review your app** for sensitive data and polish completeness -* [ ] **Test all features** work correctly with example data -* [ ] **Write clear descriptions** of value and use cases -* [ ] **Add helpful screenshots** and preview content -* [ ] **Choose effective tags** for discoverability -* [ ] **Publish to community** and monitor initial feedback -* [ ] **Engage with users** who fork and review your app +* [ ] **Review your app**: remove sensitive data and finish the app. +* [ ] **Test all features**: use example data. +* [ ] **Write a clear description**: give the value and the use cases. +* [ ] **Add screenshots**: show preview content. +* [ ] **Choose good tags**: help people find the app. +* [ ] **Publish to the community**: read the first feedback. +* [ ] **Talk with users**: answer the people who fork and review your app. ### Next Steps -1. **Browse existing community apps** for inspiration and to see what's popular -2. **Fork a few interesting apps** to understand the user experience -3. **Identify gaps in the marketplace** where your expertise can help -4. **Build and refine your solution** with community sharing in mind -5. **Publish your first community app** and start making an impact +1. Browse community apps for ideas, and see which apps are popular. +2. Fork a few apps to learn the user experience. +3. Find gaps in the marketplace where your knowledge can help. +4. Build your solution, and plan to share it. +5. Publish your first community app. *** -**🌟 Build something amazing. Share it with the world. Help teams everywhere work smarter.** - -_The future of work is collaborative, and your Genesis app could be exactly what someone needs to transform their business._ +**🌟 Build an app. Share it. Help other teams work better.** --- diff --git a/genesis-living-system-builder/community-and-sharing/faq.md b/genesis-living-system-builder/community-and-sharing/faq.md index e5187ef..d603681 100644 --- a/genesis-living-system-builder/community-and-sharing/faq.md +++ b/genesis-living-system-builder/community-and-sharing/faq.md @@ -9,73 +9,73 @@ description: >- ### What is Taskade Genesis? -Taskade Genesis is like having a personal app developer who works instantly. You describe a business problem in plain English (like "I need customers to book appointments online"), and Genesis builds a complete working app for you - no coding, no setup, no technical knowledge required. +Taskade Genesis builds apps for you from a description. You describe a business problem in plain English, for example "I need customers to book appointments online". Taskade Genesis then builds a full working app. You write no code, you configure no servers, and you need no technical knowledge. ### How is this different from other app builders? -Genesis gives you the complete backend: Databases, Automation Workflows, AI Agents, and Integrations. Other tools just make interfaces. +Many app builders make only the screens. Taskade Genesis also makes the backend: databases, automation workflows, AI agents, and integrations. -**Genesis provides:** +**Taskade Genesis gives you:** -* **Smart database** that stores your data automatically -* **AI assistant** that learns your business and helps customers -* **Automatic actions** that connect to your email, Slack, payment systems, etc. -* **Real functionality** - not just mockups or prototypes -* **Complete backend infrastructure** - hosting, security, and scaling handled automatically +* **A database** that stores your data +* **An AI assistant** that learns your business and helps your customers +* **Automatic actions** that connect to your email, Slack, payment systems, and more +* **Real functions**, not mockups or prototypes +* **A full backend**: Taskade manages hosting, security, and scaling for you -**Other app builders require:** +**With many other app builders, you must:** -* Manual database setup and configuration -* Separate hosting and deployment -* Third-party integrations you have to configure yourself -* Technical knowledge for backend functionality +* Set up and configure the database yourself +* Find hosting and deploy the app yourself +* Configure the integrations from other companies yourself +* Know how a backend works -Genesis handles all the technical complexity so you can focus on your business. +Taskade Genesis does the technical work, so you can work on your business. ### What kinds of apps can I build? **Popular app types:** -* **Customer portals** for service requests and communication -* **Team dashboards** for monitoring KPIs and workflows +* **Customer portals** for service requests and messages +* **Team dashboards** to monitor KPIs and workflows * **Booking systems** for appointments and events -* **Inventory trackers** with smart alerts and reporting -* **Feedback forms** with automated response workflows -* **Project trackers** for task and deadline management -* **Workflow automation** for repetitive business processes -* **Custom tools** for industry-specific needs +* **Inventory trackers** with alerts and reports +* **Feedback forms** with automatic response workflows +* **Project trackers** for tasks and deadlines +* **Workflow automation** for business tasks that occur again and again +* **Custom tools** for the needs of your industry ### Do I need to know how to code? -No. Genesis understands business language and handles all technical implementation automatically. You focus on describing your business needs, and Genesis handles the programming. +No. You describe your business needs in plain English. Taskade Genesis writes the code for you. ## Building Your App ### How long does it take to build an app? -**Typical timeframes:** +**Typical times:** * **Simple apps:** 2-5 minutes (basic forms, simple workflows) -* **Complex business applications:** 10-15 minutes including customization and testing -* **Enterprise-level apps:** 20-30 minutes with advanced features and integrations +* **Complex business applications:** 10-15 minutes, with customization and tests +* **Enterprise-level apps:** 20-30 minutes, with advanced features and integrations -### Can I change my app after Genesis builds it? +### Can I change my app after Taskade Genesis builds it? -Yes! Describe any changes you want and Genesis implements them immediately. Your app evolves with your business needs - just tell Genesis what you want to adjust. +Yes. Describe the change in the chat, and Taskade Genesis makes it. Your first clean build goes live one time, at an unlisted link. After that, each change stays a draft until you click **Publish**. -### What if the first version isn't quite right? +### What if the first version is not correct? -You have several options: +You have these options: -* **Make specific requests** for changes ("make the button bigger") -* **Provide more context** about what's not working -* **Start fresh** with a more detailed description if major changes are needed +* **Ask for a specific change**, for example "make the button bigger" +* **Give more context** about what does not work +* **If you need large changes, start again** with a more detailed description -Genesis gets better results with clearer requirements, so don't hesitate to be more specific about what you need. +Clear requirements give better results. Tell Taskade Genesis exactly what you need. ### Can I see examples of what other people have built? -Yes! Check out: +Yes. Look at these sources: * [**Examples and templates**](../genesis/examples-and-templates.md) in this documentation * **Taskade App Factory** at [taskade.com/apps](https://www.taskade.com/apps) @@ -86,79 +86,91 @@ Yes! Check out: ### How do I test my app before sharing it? -Use the **Preview feature** to interact with your app exactly as users will: +Use the **Preview** to use your app as your users will: -1. Open your app. It shows in the preview pane beside the chat -2. Test all functionality like a real user -3. Submit test data to ensure workflows work -4. Check that notifications and integrations trigger properly -5. Test on mobile devices if users will access via phone +1. Open your app. It shows in the preview pane next to the chat. +2. Test each feature as a real user. +3. Submit test data, and make sure that the workflows run. +4. Make sure that the notifications and integrations start correctly. +5. If your users will use a phone, test the app on a phone. ### How do I publish my app? -Every app gets an **individual URL**. Your first build goes live once at its link, unlisted: +Each app gets its own URL. Your first clean build goes live one time at its link, unlisted. Later changes stay a draft until you publish them: -1. Click **Publish** in the top-right of your app -2. Under **Who can open it**, pick **Anyone with the link**, **Anyone with the password** (Pro and up), or **Each person signs in** -3. Copy the app's address and share it anywhere: email, social media, your website -4. No downloads or installations required for users +1. Click **Publish** in the top-right corner of your app. +2. Under **Who can open it**, pick **Anyone with the link**, **Anyone with the password** (Pro and up), or **Each person signs in**. +3. To keep the app out of search, leave **Show in public listings** off under **More options**. +4. Click **Publish**, then click **Copy link**. +5. Share the link anywhere: email, social media, or your website. + +Your users do not download or install the app. They do not need a Taskade account to open it. ### Can I use my own domain name? -**Yes — custom domains are live on Pro and up** (up to 10 per workspace on Pro, unlimited on Business and up). You can connect your own branded URL (like `app.yourcompany.com`) to a published Genesis app instead of the default Genesis link, giving your apps a professional appearance that matches your brand. +**Yes. Custom domains work on Pro and up** (up to 10 per workspace on Pro, unlimited on Business and up). Connect your own URL, for example `app.yourcompany.com`, to a published Taskade Genesis app. The app then shows your brand and not the default link. ### How do users access my app? -**Simple access:** +**Access is simple:** -* Send them the link - no downloads or installations required -* Apps work in any web browser on desktop, tablet, or mobile phone -* Users can bookmark the link for easy return access +* Send them the link. They do not download or install anything. +* The app works in each web browser, on a desktop computer, a tablet, or a phone. +* Users can save the link as a bookmark and come back later. ### Can I control who uses my app? -Yes! Tell Genesis what access you want and it sets it up: +Yes. Tell Taskade Genesis what access you want, and it adds that access: * **"Make this app private with password protection"** * **"Only allow users with company email addresses"** * **"Require login for staff but allow public access for customers"** -If you set a password (Pro and up), make sure to share it along with the app link. Sign-in works on every plan. Sign-in confirms who a visitor is, but it does not hide other people's records: turn on **Private entries** to show each person only their own rows, and test with a second account. +If you set a password (Pro and up), share it together with the app link. Sign-in works on every plan. Sign-in confirms who a visitor is, but it does not hide the records of other people. To show each person only their own rows: + +1. Open **Publish** → **Private entries**. +2. Pick the owner field of each private project, then click **Enable row scoping**. +3. Pick **Each person signs in** too. Without it, anyone with the link sees all entries. +4. Test the app with a second account. + +### Can other people clone my app? + +Only if you let them. A public app is not cloneable until you turn on cloning. Open **Publish** → **Let others clone**, and pick **Off**, **Free**, or **Paid**. A clone copies the code, agents, automations, and projects. It never copies connected accounts or secrets. ## Data and Security ### Where does my app data live? -Your app and all its data live in **Taskade's secure cloud infrastructure**. This includes: +Your app and all its data are in the **secure cloud infrastructure of Taskade**. This data includes: -* Your app's projects and databases +* The projects and databases of your app * Automation workflows and settings * AI agent configurations -* User-submitted data and files +* Data and files that users submit ### Who owns the apps I create? -**You do.** Your apps, data, and intellectual property belong to you completely. We provide the platform and infrastructure, but everything you build and all the content within your apps remains your property. You can modify or delete data at any time. +**You do.** Your apps, data, and intellectual property belong to you. We supply the platform and infrastructure. All that you build and all the content in your apps stay your property. You can change or delete data at any time. ### Is my data secure? Yes. Taskade uses enterprise-grade security: * **Encryption in transit and at rest** -* **Security monitoring** and automated vulnerability scanning -* **SOC 2 Type II readiness program** (the independent audit is not yet complete) +* **Security monitoring** and automatic vulnerability scans +* **SOC 2 Type II readiness program** (the independent audit is not yet completed) * **Role-based access controls** * **Automatic backups** to prevent data loss ### Can I export my data? -Yes. You can export your app data in standard formats (CSV, JSON) at any time. This ensures you're never locked into the platform and can migrate data if needed. +Yes. You can export your app data in standard formats (CSV, JSON) at any time. You are never locked in to the platform, and you can move your data. On Pro and up, you can also download the full app as a `.tsk` file or export it to GitHub. ### What about GDPR and privacy compliance? -Taskade's practices are designed to align with GDPR (full compliance is in progress), and Taskade provides tools to help you meet privacy requirements: +Taskade designs its practices to align with GDPR (full compliance is in progress). Taskade also gives you tools for privacy requirements: -* **User consent management** built into apps +* **User consent management** in apps * **Data deletion tools** for user requests * **Privacy policy templates** for your apps @@ -166,7 +178,7 @@ Taskade's practices are designed to align with GDPR (full compliance is in progr ### What integrations are available? -**100+ integrations** including: +**100+ integrations**, for example: * **Communication:** Slack, Microsoft Teams, Discord * **Email:** Gmail, Outlook, Mailchimp @@ -174,20 +186,24 @@ Taskade's practices are designed to align with GDPR (full compliance is in progr * **Payments:** Stripe * **CRM:** HubSpot, Salesforce, Pipedrive * **Project management:** Trello, Asana, Monday.com -* **And many more...** +* **And more** -Can't find what you need? Contact support - we add new integrations regularly. +If you cannot find the integration that you need, contact support. We add new integrations regularly. ### Can I connect to my existing systems? -Yes! Genesis can integrate with: +Yes. Taskade Genesis can connect to: * **Your current CRM or database** -* **Existing email marketing tools** -* **Accounting software** through webhooks or HTTP requests +* **Your email marketing tools** +* **Accounting software**, through webhooks or HTTP requests * **Calendar systems** for scheduling * **Custom APIs** with webhook support +### Can people send files through my app? + +Yes. Add a file upload field to a form. People then attach a document or a photo when they submit. The file goes to your Media Files. A **Turn a file into text** step in an automation can read the words, also from a scan or a phone photo. Each file can be up to 10 MB, on every plan. + ### What happens if Taskade goes down? **Reliability measures:** @@ -195,53 +211,56 @@ Yes! Genesis can integrate with: * **High-availability infrastructure** with redundancy * **Automatic failover** systems * **Real-time status monitoring** at taskade.statuspage.io -* **Data backups** stored in multiple locations +* **Data backups** in more than one location ### Can I get help with complex integrations? -Yes! Several support options: +Yes. You have these support options: * **Email support** for technical questions -* **Live chat** for immediate help -* **Community forums** for peer assistance -* **Professional services** for enterprise implementations +* **Live chat** for fast help +* **Community forums** for help from other users +* **Professional services** for enterprise projects ## Billing and Plans ### How much does Genesis cost? -Genesis is included with Taskade subscriptions: +Taskade Genesis is part of each Taskade plan: -* **Free plan:** up to 3 Genesis apps, 1 AI agent, and 2 workspace members +* **Free plan:** up to 3 Taskade Genesis apps, 1 AI agent, and 2 workspace members * **Starter and up:** unlimited apps * **Pro and up:** custom domains, webhooks, and app bundle export * **Business and up:** SSO/SAML, app analytics, and unlimited members -Visit [taskade.com/pricing](https://taskade.com/pricing) for current pricing. +See [taskade.com/pricing](https://taskade.com/pricing) for current prices. -### What's included in the free plan? +### What is included in the Free plan? -**Free plan includes:** +**The Free plan includes:** * **App creation** with Taskade Genesis (up to 3 apps) +* **Free cloning** of app kits from Taskade App Factory * **Automations** with standard connectors (10 runs per billing period). Premium integrations need a paid plan. -* **AI credits** you earn with referrals and invites (a Free workspace starts with 0) -* **Standard support** via help center -* **Community access** for questions and inspiration +* **AI credits** that you earn with referrals and invites (a Free workspace starts with 0) +* **Standard support** in the help center +* **Community access** for questions and ideas + +On Free, Taskade EVE asks you to pick a plan before your first build. -### When should I upgrade to a paid plan? +### When do I upgrade to a paid plan? -**Consider upgrading when you need:** +**Upgrade when you need:** -* **More than 3 apps** for different business functions +* **More than 3 apps** for different parts of your business * **Advanced integrations** with business tools * **Team collaboration** features -* **Priority support** for business-critical apps +* **Priority support** for apps that your business depends on * **Custom branding** and domain options ### Can I try advanced features before upgrading? -The Free plan has no time limit. Start on Free, build and publish apps, and upgrade when you need more apps, premium integrations, or custom domains. +The Free plan has no time limit. Start on Free and clone an app kit at no cost. When you need to build your own apps, more apps, premium integrations, or custom domains, upgrade. ## Getting Support @@ -251,42 +270,42 @@ The Free plan has no time limit. Start on Free, build and publish apps, and upgr * **Help documentation:** [taskade.com/learn/genesis](https://www.taskade.com/learn/genesis) * **Video tutorials:** [youtube.com/taskade](https://youtube.com/taskade) -* **Community forums:** Connect with other users -* **This documentation:** Comprehensive guides and examples +* **Community forums:** Talk with other users +* **This documentation:** Guides and examples **Direct support:** * **Email support:** [support@taskade.com](mailto:support@taskade.com) -* **Live chat:** Available in your Taskade dashboard +* **Live chat:** In your Taskade dashboard * **Community help:** Forums and user groups ### How do I report a bug or request a feature? -**For bugs:** +**For bugs, send an email to support with:** -* **Email support** with detailed description -* **Include screenshots** if helpful -* **Provide your app URL** for faster troubleshooting +* **A detailed description** of the bug +* **Screenshots**, if they help +* **Your app URL**, so that we can find the problem faster -**For feature requests:** +**For feature requests, use these channels:** -* **Community forums** to see if others want the same feature -* **Email support** with business justification -* **User feedback** surveys when available +* **Community forums**, to see if other users want the same feature +* **Email support**, with the business reason for the feature +* **User feedback** surveys, when we send them -### What should I include in a support request? +### What do I put in a support request? -**Essential information:** +**Give this information:** -* **What you're trying to build** (copy your prompt) -* **What you expected** to happen -* **What actually happened** (include screenshots if helpful) -* **Your app URL** if you need help with a specific issue -* **Error messages** if any appeared +* **What you want to build** (copy your prompt) +* **What you expected** to occur +* **What occurred** (add screenshots if they help) +* **Your app URL**, if the problem is in one app +* **Error messages**, if they showed ### Can Genesis itself help me? -Yes! **Ask the AI agent directly:** +Yes. **Ask the AI agent in the chat:** ``` "What features should I add to make this app better for my customers?" @@ -296,161 +315,161 @@ Yes! **Ask the AI agent directly:** "What integrations would be most useful for a restaurant feedback app?" ``` -The Genesis AI agent can provide suggestions, troubleshoot issues, and help you improve your apps. +The AI agent in Taskade Genesis gives suggestions, finds the cause of problems, and helps you improve your apps. ## Best Practices ### How do I write better prompts? -**Follow the formula:** Industry + Users + Problem + Solution + Outcome +**Use the formula:** Industry + Users + Problem + Solution + Outcome -**Be specific about:** +**Give these details:** -* **Your industry** and business type +* **Your industry** and type of business * **Who will use** the app and how -* **What problem** you're solving -* **What should happen** when users complete actions +* **The problem** that the app solves +* **What must occur** when users finish a task -**Genesis AI Tip:** Ask the AI agent itself for suggestions! Try prompts like "What features should I add to make this app better?" or "How can I improve the user experience?" +**Tip:** Ask the AI agent for suggestions. Try prompts such as "What features should I add to make this app better?" or "How can I improve the user experience?" See our [Best Practices guide](best-practices.md) for detailed examples. -### Should I build one big app or several smaller ones? +### Do I build one big app or several smaller ones? -**Generally, smaller focused apps work better:** +**Usually, small apps with one purpose work better:** -* **Easier to build** and test thoroughly -* **Simpler for users** to understand and use -* **Faster performance** and loading times -* **Easier to maintain** and update +* **They are easier to build** and to test fully +* **They are simpler for users** to understand and use +* **They load faster** +* **They are easier to maintain** and update -**Consider one large app when:** +**Build one large app in these cases:** -* Users need to access multiple functions in one session -* Data needs to be shared between different functions -* You want a unified dashboard for everything +* Users need many functions in one session. +* Different functions must share the same data. +* You want one dashboard for everything. -### How often should I update my app? +### How often do I update my app? -**Regular maintenance schedule:** +**A regular maintenance schedule:** -* **Weekly:** Check that integrations are working -* **Monthly:** Review user feedback and usage data -* **Quarterly:** Consider new features or improvements -* **As needed:** Fix bugs or address user complaints immediately +* **Each week:** Make sure that the integrations work. +* **Each month:** Read user feedback and usage data. +* **Each quarter:** Plan new features or improvements. +* **When a problem occurs:** Fix bugs and user complaints at once. ### How do I get inspiration for app ideas? -**Multiple sources of inspiration:** +**Sources of ideas:** -* **Community showcase:** Browse real apps built by other users -* **Examples and templates:** Review our curated collection of app ideas -* **Industry-specific guides:** See how Genesis is used in your field -* **AI assistance:** Ask Genesis "What apps are popular in \[your industry]?" -* **Video tutorials:** Watch real examples being built on YouTube +* **Community showcase:** Real apps that other users built +* **Examples and templates:** Our collection of app ideas +* **Industry guides:** How people in your field use Taskade Genesis +* **AI aid:** Ask Taskade Genesis "What apps are popular in \[your industry]?" +* **Video tutorials:** Real builds on YouTube *** ## Quick Answers -**Q: Can I duplicate an app I've built?** A: Yes. Open the app's menu and choose **Duplicate app**. On Free, each copy counts toward your 3 apps. +**Q: Can I duplicate an app that I built?** A: Yes. Open the menu of the app and choose **Duplicate app**. On Free, each copy counts toward your 3 apps. -**Q: What's the maximum number of users per app?** A: No hard limits, but performance may vary based on your plan and usage patterns. +**Q: What is the maximum number of users for each app?** A: There is no hard limit. Performance can change with your plan and your usage. **Q: Can I white-label my apps?** A: Every paid plan can hide the "Powered by Taskade" badge. Custom app colors and SEO fields need Business and up. -**Q: Do my apps work offline?** A: Basic functionality may work offline, but most features require an internet connection. +**Q: Do my apps work offline?** A: Some basic functions can work offline. Most features need an internet connection. -**Q: Can I get my app code?** A: Yes, on Pro and up. Read and edit the source in the Code tab, download the app bundle, or export it to GitHub. Apps stay hosted on Taskade's platform. +**Q: Can I get my app code?** A: Yes, on Pro and up. Read and edit the source in the Code tab, download the app bundle, or export it to GitHub. Apps stay hosted on the Taskade platform. *** ## Getting Support -**Multiple ways to get help:** +**You can get help in three ways:** -1. **Start with our guides and video tutorials** - Comprehensive documentation and video walkthroughs -2. **Email support@taskade.com with details** - Direct support from our technical team -3. **Browse our community showcase for examples** - See real apps built by other users for inspiration +1. **Start with our guides and video tutorials.** They show the full steps. +2. **Send the details to support@taskade.com.** Our technical team answers you. +3. **Look at our community showcase.** It shows real apps that other users built. -**⚡️ Pro tip:** Ask Genesis itself for suggestions! Try prompts like "What features should I add to make this app better?" or "How can I improve the user experience?" Genesis can recommend enhancements tailored for your app. +**⚡️ Tip:** Ask Taskade Genesis for suggestions. Try prompts such as "What features should I add to make this app better?" or "How can I improve the user experience?" Taskade Genesis suggests improvements for your app. -**Still have questions?** +**Do you have more questions?** -* **Browse our help center:** [taskade.com/learn/genesis](https://www.taskade.com/learn/genesis) +* **Read our help center:** [taskade.com/learn/genesis](https://www.taskade.com/learn/genesis) * **Email us:** [support@taskade.com](mailto:support@taskade.com) -* **Browse community apps:** [taskade.com/apps](https://www.taskade.com/apps) +* **See community apps:** [taskade.com/apps](https://www.taskade.com/apps) -**Ready to start building?** [Open Genesis in your workspace →](https://taskade.com) +**Ready to build?** [Open Taskade Genesis in your workspace →](https://taskade.com) *** ## Living Software FAQ -**Understanding the paradigm shift from static apps to living systems.** +**How living systems differ from static apps.** ### What is Living Software? -Living software actively learns, adapts, and evolves based on usage patterns, user interactions, and environmental changes. Unlike traditional static software that requires manual updates, living software continuously improves its capabilities and intelligence. +Living software learns from use. It changes with the needs of your users and your business. A static app keeps the same features until a person updates it. Living software adds to its capabilities over time. ### How is living software different from regular apps? -Traditional apps are static tools with fixed features and manual maintenance. Living systems are dynamic ecosystems that: +A traditional app is a static tool with fixed features. A person must maintain it by hand. A living system: -* Learn from every user interaction -* Adapt to changing business needs -* Connect insights across all components -* Evolve their capabilities over time +* Learns from each user action +* Changes when your business needs change +* Connects data across all its parts +* Adds capabilities over time ### What is Workspace DNA? -Workspace DNA is the fundamental architecture of living software, consisting of three interconnected layers: Memory, Intelligence, and Execution. This trinity enables systems that think, learn, and act intelligently. +Workspace DNA is the architecture of living software. It has three connected layers: Memory, Intelligence, and Execution. Together, these layers let a system think, learn, and act. ### How do AI agents become "living"? -AI agents become living through continuous learning from interactions, context awareness, and adaptation to user needs. They improve with every conversation and task. +AI agents learn from each conversation and task. They use the context of your workspace and change to fit the needs of your users. ### How do automations become "living"? -Living automations learn from success patterns, adapt timing and conditions, and continuously optimize performance based on real-world results. +Living automations use the results of earlier runs. You can change their timing and conditions as you learn what works best. ### What are Living Systems? -Living Systems are complete business solutions that combine the three DNA layers into cohesive, evolving ecosystems. Unlike static applications, they grow more valuable with use. +A living system is a full business solution. It combines the three DNA layers into one system that changes with your business. A living system becomes more valuable as people use it. ### How do I build a living system? -Describe your needs in natural language using Genesis, and the system automatically creates a complete living solution with memory, intelligence, and execution layers working together. +Describe your needs in plain language to Taskade Genesis. It builds a full system with memory, intelligence, and execution layers that work together. ### Can living systems work together? -Yes! Living systems share intelligence and learn from each other. A customer feedback system can inform inventory management, which can trigger marketing automations. +Yes. Living systems can share data. For example, a customer feedback system can send data to an inventory system, and that data can start a marketing automation. ### Do I need to rebuild my existing workflows? -No! Living systems can enhance and evolve your existing processes. You can start with simple automations and gradually add intelligence and memory layers. +No. Living systems can improve the processes that you have today. You can start with simple automations, then add intelligence and memory layers step by step. ### Is living software more expensive? -Living software provides better ROI through continuous improvement and reduced maintenance. Systems that learn and adapt require less manual intervention over time. +Living software gives a better return because it improves over time. A system that learns and changes needs less manual work. ### How do I get started with living software? -Start with Taskade Genesis to build your first living system, or explore App Kits for ready-to-deploy solutions. The Workspace DNA foundation works with your existing tools. +Build your first living system with Taskade Genesis, or start from an App Kit. The Workspace DNA foundation works with the tools that you use today. ### What business benefits do living systems provide? -Living systems deliver continuous improvement, predictive capabilities, scalable intelligence, adaptive resilience, and operational excellence. +Living systems improve over time, help you plan, grow with your business, and keep your operations stable when needs change. ### Can living systems handle compliance and security? -Yes! Living systems can be designed with enterprise-grade security, compliance features, and governance controls that evolve with regulatory requirements. +Yes. You can design living systems with enterprise-grade security, compliance features, and governance controls. ### How will living software evolve? -Future living systems will feature more sophisticated learning algorithms, deeper cross-system intelligence sharing, advanced predictive capabilities, and seamless human-AI collaboration. +Future living systems will learn better, share more data across systems, predict more, and work more closely with people. -**Living software represents the next evolution of business systems - from tools that humans use to intelligent partners that work alongside us.** +**Living software is the next step for business systems: from tools that people use to AI partners that work with them.** --- diff --git a/genesis-living-system-builder/community-and-sharing/genesis-auth.md b/genesis-living-system-builder/community-and-sharing/genesis-auth.md index 771681d..2fa5488 100644 --- a/genesis-living-system-builder/community-and-sharing/genesis-auth.md +++ b/genesis-living-system-builder/community-and-sharing/genesis-auth.md @@ -5,124 +5,127 @@ description: >- # GenesisAuth -A dedicated security layer for Taskade Genesis apps. Every Taskade Genesis app can ship with real user accounts and secure sign-in — no code, no third-party provider setup, no DevOps. +GenesisAuth gives each Taskade Genesis app real user accounts and secure sign-in. You write no code. You do not configure a sign-in service from another company, and you do not manage servers. --- ## What Is GenesisAuth -GenesisAuth is the authentication layer for apps built with Taskade Genesis. When you describe an app that needs user accounts, Taskade wires up secure sign-in automatically — session management, credential handling, and access control all work out of the box. +GenesisAuth is the sign-in system for apps that you build with Taskade Genesis. When you describe an app that needs user accounts, Taskade adds secure sign-in to the app. It also manages the sessions, the passwords, and the access control for you. -* **Built-in user accounts.** No Auth0 or Clerk to wire up, no schema to design. -* **Pre-built sign-in component** added to the generated app automatically. -* **Scales with your app.** Handles sessions, password hashing, and session tokens securely. -* **Turns every Taskade Genesis app into a real multi-user product.** +* **Built-in user accounts.** You do not connect Auth0 or Clerk, and you do not design a schema. +* **Sign-in component.** Taskade adds a ready sign-in screen to the app that it builds. +* **Grows with your app.** GenesisAuth keeps sessions, password hashes, and session tokens secure. +* **Many users in one app.** Each person who uses your app gets their own account. --- ## Turning Any App Into a Multi-User Product -You don't configure GenesisAuth manually — you describe the need. +You do not configure GenesisAuth by hand. You describe what you need: -1. In Taskade Genesis, describe your app in plain language. Include phrases like: +1. In Taskade Genesis, describe your app in plain language. Use words such as: * *"a client portal where each client has their own dashboard"* * *"users can sign in to see their own habit streaks"* * *"a members-only knowledge base"* -2. Taskade EVE generates the app **with the sign-in component in place**. -3. Open the app's settings to review the **App Users** tab. +2. Wait for Taskade EVE to build the app **with the sign-in component in place**. +3. Open the settings of the app and go to the **App Users** tab. -That's it. Your app now accepts user sign-ups and handles sign-in. Sign-in confirms who a visitor is. It does not hide other people's records: to show each person only their own rows, turn on **Private entries** (row scoping, off by default) and test with a second account. See [Give each user only their own rows](../run-your-business/add-login-and-roles.md#give-each-user-only-their-own-rows). +Your app then accepts sign-ups and sign-ins. Sign-in confirms who a visitor is. It does not hide the records of other people. To show each person only their own rows, turn on **Private entries** (row scoping, off by default). Then pick the owner field that matches each row to a login, and test with a second account. See [Give each user only their own rows](../run-your-business/add-login-and-roles.md#give-each-user-only-their-own-rows). {% hint style="info" %} -If your first prompt doesn't trigger auth setup, you can add it later by asking Taskade EVE to *"add sign-in for users"* while editing the app. +If your first prompt does not add sign-in, you can add it later. Ask Taskade EVE to *"add sign-in for users"* while you edit the app. {% endhint %} {% hint style="success" %} -**Sign-in is always real.** If a build or edit ever produces a login screen that doesn't actually authenticate, Taskade EVE detects it and automatically replaces it with working, persistent authentication — GenesisAuth sign-in by default, or secure hashed-credential storage for apps that manage their own user directory. EVE tells you when it makes this repair. +**Sign-in is always real.** Sometimes a build or an edit makes a login screen that does not sign people in. Taskade EVE finds that screen and replaces it with working, persistent sign-in. By default, it uses GenesisAuth. An app that keeps its own list of users gets secure hashed-credential storage. Taskade EVE tells you when it makes this repair. {% endhint %} --- ## The App Users Tab -The **App Users** tab lives in your Taskade Genesis app's settings (**App settings → People & access → App users**). It's a first-class user management dashboard. +The **App Users** tab is in the settings of your Taskade Genesis app (**App settings → People & access → App users**). On this tab, you manage the people who use your app. ### What You Can Do -* See the list of end users who have signed in to your app. +On the **App Users** tab, you can: + +* See the list of the people who signed in to your app. * Add a person by email with **Add person**. Taskade emails them a link to set a password. * Choose who can sign up: **Anyone** or **Invite only**. -* Disable an account without deleting it, and re-enable it later. -* Delete accounts entirely. +* Make a person an **Admin** or a **Member** of the app. A role decides what the app shows. It is not a data permission, with two narrow exceptions such as **Admins see every row** in **Private entries**. See [Give admins the full view](../run-your-business/add-login-and-roles.md#give-admins-the-full-view). +* Disable an account without deleting it, and enable it again later. +* Delete an account. -All without touching code. +You do all of this with no code. {% hint style="info" %} -The App Users tab is currently in Beta. App Users and app sign-in work on every plan, Free included — bug reports welcome at [github.com/taskade/taskade/issues](https://github.com/taskade/taskade/issues). +The App Users tab is in Beta. App Users and app sign-in work on every plan, Free included. Send bug reports to [github.com/taskade/taskade/issues](https://github.com/taskade/taskade/issues). {% endhint %} --- ## Workspace Single Sign-On -Workspace SSO (SAML) is company single sign-on for your own team members inside Taskade. It is available on Business and up. See [Account Management](../../account-management/README.md). +Workspace SSO (SAML) is company single sign-on for the members of your team inside Taskade. It is available on Business and up. See [Account Management](../../account-management/README.md). -* Workspace SSO is a separate feature from GenesisAuth. -* Taskade workspace credentials do not open an app account. People who use a published app, your teammates included, sign in with an app account. +* Workspace SSO is a different feature from GenesisAuth. +* Taskade workspace credentials do not open an app account. Each person who uses a published app signs in with an app account. This rule also applies to your teammates. * For an internal tool, add each teammate on the **App Users** tab, or set **Who can sign up** to **Invite only**. --- ## Custom Domain Sign-In -GenesisAuth works seamlessly on apps hosted at your own domain. +GenesisAuth also works on apps that use your own domain. -* No additional configuration required when you connect a custom domain. -* Session cookies and redirects handle custom domains correctly. -* Specific reliability improvements were added for sign-in flows on custom domains. +* You do not configure more settings when you connect a custom domain. +* Session cookies and redirects work correctly on custom domains. +* Taskade made sign-in on custom domains more reliable. {% hint style="success" %} -Combine GenesisAuth with a [custom domain](../space-apps-guide/custom-domains.md) to deliver a fully branded, production-ready product to end users. +Use GenesisAuth together with a [custom domain](../space-apps-guide/custom-domains.md). Your users then get a product with your own brand and address. {% endhint %} --- ## Access Control -GenesisAuth is part of a broader access-control story. +GenesisAuth is one of several access controls. This table compares them: | Control | What It Does | When to Use | | --- | --- | --- | -| GenesisAuth (App Users) | Account-based sign-in for app end users, on every plan | Any multi-user app, internal tools included | +| GenesisAuth (App Users) | Sign-in with an account for the people who use your app, on every plan | Each app with more than one user, internal tools included | | Private entries (row scoping) | Shows each signed-in person only the rows that match their login. Off by default | Client portals, member areas | -| Workspace SSO | Company single sign-on for your team inside Taskade (Business and up). It does not sign people in to a published app | Your own team's Taskade accounts | -| Password-protected public links | Single shared password for a link (Pro and up) | Quick gated preview | -| Listed / Unlisted | Controls discoverability (**Show in public listings**) | Non-indexed sharing | +| Workspace SSO | Company single sign-on for your team inside Taskade (Business and up). It does not sign people in to a published app | The Taskade accounts of your own team | +| Password-protected public links | One shared password for a link (Pro and up) | A quick preview with a lock | +| Listed / Unlisted | Controls if people can find the app (**Show in public listings**) | Share by link only, not in search | | Public agent tool opt-out | Sensitive tools stay workspace-only | Published agents |
--- -## How It Works Under the Hood +## How It Works Internally -You don't need to know these details to use GenesisAuth, but they matter if you're auditing the security model. +You do not need these details to use GenesisAuth. They help if you review the security model. -* **Token-based session management.** Sign-in produces a secure session token stored in an HTTP-only cookie. -* **Sessions persist across updates.** Signed-in users stay signed in through app updates — no forced re-login. -* **No credentials in the app bundle.** Exported app bundles never contain end-user credentials or session tokens — only the app structure. -* **Per-app user isolation.** Each Genesis app's App Users list is scoped to that app. +* **Token-based session management.** Sign-in makes a secure session token. The browser keeps it in an HTTP-only cookie. +* **Sessions persist across updates.** Signed-in users stay signed in after an app update. They do not sign in again. +* **No credentials in the app bundle.** An exported app bundle never holds the credentials or session tokens of your users. It holds only the app structure. +* **Per-app user isolation.** Each Taskade Genesis app has its own App Users list. --- ## Security Best Practices -* **Review exposed tools.** For public agents, opt sensitive tools out so external users can't invoke them. -* **Disable instead of delete** when you want to retain a user's history but block access. -* **Use a custom domain with TLS** for any app that handles user data in production. -* **OIDC sign-in is hardened by default.** App sign-in runs on OIDC, with Taskade as the identity provider. PKCE is an OAuth security check that stops intercepted sign-in codes from being replayed. Taskade accepts only the S256 PKCE method and validates that `redirect_uri` matches your app's own origin. See [App Sign-In (OIDC)](publish-and-clone.md#app-sign-in-oidc) and the [authentication guide](../../apis-living-system-development/developers/authentication.md). -* **Monitor sign-in activity** via the App Users tab and your workspace activity log. -* **Rotate workspace tokens** periodically if you also expose the app via the [Public API](../../apis-living-system-development/developers/authentication.md). +* **Review exposed tools.** For a public agent, turn off the sensitive tools. People outside your workspace then cannot use them. +* **Disable instead of delete.** If you want to keep the history of a user but block access, disable the account. +* **Use a custom domain with TLS** for each production app that holds user data. +* **OIDC sign-in is hardened by default.** App sign-in runs on OIDC, with Taskade as the identity provider. PKCE is an OAuth security check. It stops a person from using a stolen sign-in code again. Taskade accepts only the S256 PKCE method. Taskade also makes sure that `redirect_uri` matches the origin of your app. See [App Sign-In (OIDC)](publish-and-clone.md#app-sign-in-oidc) and the [authentication guide](../../apis-living-system-development/developers/authentication.md). +* **Monitor sign-in activity** on the App Users tab and in the activity log of your workspace. +* **Rotate workspace tokens.** If you also give access to the app through the [Public API](../../apis-living-system-development/developers/authentication.md), rotate the tokens at regular intervals. --- diff --git a/genesis-living-system-builder/community-and-sharing/publish-and-clone.md b/genesis-living-system-builder/community-and-sharing/publish-and-clone.md index e228ad8..67439bc 100644 --- a/genesis-living-system-builder/community-and-sharing/publish-and-clone.md +++ b/genesis-living-system-builder/community-and-sharing/publish-and-clone.md @@ -9,24 +9,24 @@ description: >- ## Overview -Once you've built an app with Taskade Genesis, you can share it with the world in multiple ways — from private team tools to public community templates. This guide covers every publishing, sharing, and distribution option available. +After you build an app with Taskade Genesis, you can share it in many ways. You can keep it as a private team tool, or share it as a public community template. This guide covers each publishing, sharing, and distribution option. -> **Haven't built an app yet?** Start with [Create Your First App](../genesis/getting-started.md). +> **No app yet?** Start with [Create Your First App](../genesis/getting-started.md). --- ## What "Publish" Means -When you publish a Genesis app, it becomes a **live, accessible application**: +When you publish a Taskade Genesis app, it becomes a **live app that people can open**: | What Happens | Detail | |---|---| -| **Live URL** | Your app gets a shareable URL anyone can access | -| **Real-time functionality** | All features work — forms, databases, agents, automations | -| **Powered by your workspace** | Backend databases, AI agents, and automations run live | -| **Clone-ready** | Others can fork your app into their own workspace, if you turn on **Let others clone** | -| **Analytics active** | Visitor tracking begins immediately (App Analytics dashboard on Business and up) | -| **Version controlled** | Every published version is saved and restorable | +| **Live URL** | Your app gets a link that you can share. | +| **Real-time functions** | Forms, databases, agents, and automations all work. | +| **Your workspace runs it** | The databases, AI agents, and automations of your workspace run live. | +| **Clone-ready** | If you turn on **Let others clone**, other people can copy your app into their own workspace. | +| **Analytics active** | Visitor tracking starts at once. The App Analytics dashboard is on Business and up. | +| **Version control** | Taskade saves each published version, and you can restore it. | @@ -34,7 +34,7 @@ When you publish a Genesis app, it becomes a **live, accessible application**: ## App Visibility Settings -Open **Publish** and pick who can open the app under **Who can open it**: +Open **Publish**. Under **Who can open it**, pick who can open the app: | Choice | What Visitors Do | Plan | |---|---|---| @@ -42,110 +42,138 @@ Open **Publish** and pick who can open the app under **Who can open it**: | **Anyone with the password** | Type one shared password first | Pro and up | | **Each person signs in** | Sign in with their own app account ([GenesisAuth](genesis-auth.md)) | All plans | -Then set discoverability under **More options**: +Then set who can find the app, under **More options**: -| Visibility | Who Can Access | Discoverable | +| Visibility | Who Can Open It | Who Can Find It | |---|---|---| -| **Listed** (**Show in public listings** on) | Anyone who can open it | Yes — public listings and search. The Taskade App Factory after approval ([see below](#publish-to-the-taskade-app-factory)) | -| **Unlisted** (called Secret in earlier versions) | Anyone with the link | No — link-only access | -| **Draft / unpublished** | Your workspace team only, inside Taskade | No | +| **Listed** (**Show in public listings** on) | Anyone who can open it | Public listings and search. The Taskade App Factory after approval ([see Publish to the Taskade App Factory](#publish-to-the-taskade-app-factory)) | +| **Unlisted** (called Secret in earlier versions) | Anyone with the link | Nobody. Only people with the link can open it | +| **Draft / unpublished** | Your workspace team only, inside Taskade | Nobody | -Best for: +Each choice fits a different use: - **Listed:** templates, showcases, community tools, and marketing. - **Unlisted:** client portals, team tools, and partner apps. -- **Draft / unpublished:** apps you are still building, and internal testing. +- **Draft / unpublished:** apps that you still build, and internal tests. --- ## Publishing Strategies -Genesis supports two publishing strategies: +Taskade Genesis has two publishing strategies: | Strategy | How It Works | Best For | |---|---|---| -| **Auto** | Every change is published immediately | Development/testing phase, rapid iteration, internal tools | -| **Manual** | You choose when to publish | Production apps, client-facing tools, quality-controlled releases | +| **Auto** | Taskade publishes each change at once | Tests, fast changes, and internal tools | +| **Manual** | You choose when to publish | Production apps, client-facing tools, and controlled releases | -> **Tip:** Start with Auto while building, switch to Manual when your app is live with real users. You can change this anytime in app settings. Both strategies work on every plan, Free included. +Both strategies work on every plan, Free included. You can change the strategy at any time in the app settings. Auto is good while you build. Manual is good when real users use your app. + +{% hint style="info" %} +**New apps save changes as drafts.** When Taskade EVE finishes the first build of a new app, the app goes live once at its link, unlisted. After that, Taskade saves each change as a draft. Visitors see a change only after you click **Publish** again. The header button reads **Update** when changes wait to go live, and **Live** when the app is up to date. +{% endhint %} --- ## Password Protection -Add an extra layer of security to any published app: +Add a password to a published app (Pro and up): + +1. Click **Publish**. +2. Under **Who can open it**, pick **Anyone with the password**. +3. Type your password. +4. Click **Save password**. On a draft, **Publish** also saves the typed password. +5. Read the line under the field. It says "Password protection is on". +6. Wait about a minute. Then test the password in a private browser window. +7. Send the password to your users through a secure channel. -1. Click **Publish** -2. Under **Who can open it**, pick **Anyone with the password** -3. Type your password and click **Update password** -4. Share the password separately with authorized users +To change the password: + +1. Click **Change password** in the **Publish** panel. +2. Type the new password. +3. Click **Update password**. + +To remove the password, pick **Anyone with the link** under **Who can open it**. If the app also needs sign-in, click **Remove password**. | Feature | Detail | |---|---| | Available on | Pro and up | -| Protection level | Site-wide — covers entire app | -| Password sharing | Manual (share via secure channel) | -| Can be changed | Yes, anytime with **Change password** or **Remove password** (also in **App settings → People & access → Security**) | +| Protection level | The whole app | +| Password sharing | You send it yourself, through a secure channel | +| Also set in | **App settings → Launch → Publish**, for a draft app and a published app | --- ## Publish to the Taskade App Factory -Share your app with the entire Taskade community: +Share your app with the whole Taskade community: -1. Under **More options**, turn on **Show in public listings** -2. Click **"Publish to Community"** -3. Your app enters the community approval queue -4. Once approved, it appears in the public Taskade App Factory +1. Under **More options**, turn on **Show in public listings**. +2. Click **Publish to Community**. +3. Wait for approval. Your app goes into the community approval queue. + +After approval, your app shows in the public Taskade App Factory. ### Community App Metrics -Published community apps track engagement automatically: +Taskade tracks these numbers for each published community app: | Metric | What It Measures | |---|---| -| **Views** | How many people viewed your app | -| **Likes** | Community engagement and endorsement | -| **Installs** | How many people cloned/forked your app | -| **Intelligence Score** | Your app's DNA maturity (0–100) | +| **Views** | How many people looked at your app | +| **Likes** | How many people liked your app | +| **Installs** | How many people cloned your app | +| **Intelligence Score** | How complete the Workspace DNA of your app is (0–100) | -> **Community status flow:** Pending → Approved / Rejected. You can unsubmit anytime. +> **Community status:** Pending → Approved or Rejected. You can withdraw your app at any time. --- ## Clone and Remix Apps -Cloning is the fastest way to start — pick a working app, copy it to your workspace, and customize it instead of building from a blank prompt. Browse apps to clone in Taskade App Factory at [taskade.com/apps](https://www.taskade.com/apps) and [Taskade's official kits](https://www.taskade.com/apps/official). +A clone is the fastest way to start. You copy a working app to your workspace and change it. You do not start from a blank prompt. Browse apps to clone in the Taskade App Factory at [taskade.com/apps](https://www.taskade.com/apps) and in [Taskade's official kits](https://www.taskade.com/apps/official). + +A public app is not cloneable by default. People can clone an app only when its creator turns on **Let others clone** (**Free** or **Paid**). A kit with a **PRO** badge needs a paid plan to clone. -A public app is not cloneable by default. An app can be cloned only when its creator turns on **Let others clone** (**Free** or **Paid**). A kit with a **PRO** badge needs a paid plan to clone. +1. Open the public listing of the app. +2. Click **Clone**. This button shows only on a free or paid kit. +3. Read the list of contents that Taskade shows. +4. Choose the destination workspace. -1. Open the app's public listing -2. Click **"Clone"** (shown only on a free or paid kit) -3. Review the contents Taskade lists, then choose the destination workspace -4. The app is copied to your workspace with its components +Taskade then copies the app and its parts to your workspace. -To let others clone your own app, open **Publish → Let others clone** and pick **Free** or **Paid** (**Off** stops new clones). This control was called "Share as Template" and then "Share as kit" in earlier versions. +A creator can archive a kit or the workspace behind it. Taskade can also take a kit down. In both cases, the kit page says that the app is no longer available, and it has no **Clone** button. A person who bought a paid kit can still open its page and clone it. A copy that you cloned before stays in your workspace. + +### Let Others Clone Your App + +1. Open **Publish → Let others clone**. +2. Pick **Free** or **Paid**. **Off** stops new clones. + +In earlier versions, this control had the name "Share as Template" and then "Share as kit". + +After you publish an app that you built, the dialog that says your app is live can show the line **Share as a free template in the app gallery**. Click **Add** to do the same as **Let others clone** set to **Free**. To hide the line for that app in this browser, click **x** (**Not now**). Only the app owner sees the line. An app that came from a paid or PRO kit can be added for people to open, but not to clone. ### What Gets Cloned | Component | Cloned? | Notes | |---|---|---| -| **UI / Frontend** | Yes | Full React app code | -| **Project databases** | Yes | Structure + data. A project that holds what visitors sent (form answers, sign-ups) ships without those rows, unless the creator ships it as sample data | -| **AI agents** | Yes | Agent config + knowledge references | -| **Automations** | Yes | Flow definitions. Connected accounts are not copied, so connect your own | +| **UI / Frontend** | Yes | The full React app code | +| **Project databases** | Yes | Structure and data. A project that holds what visitors sent (form answers, sign-ups) ships without those rows. If the creator ships it as sample data, only the creator's own example rows come with it. A project where each person sees only their own entries never ships its rows | +| **AI agents** | Yes | Agent settings and knowledge references. Each tool keeps the creator's choice: visitors of a public agent can use it, or they cannot | +| **Access settings** | Yes | **Invite only** sign-up and **Private entries** with an owner field carry over to your copy. Test your copy with a second account before you share it | +| **Automations** | Yes | The automation steps. Taskade does not copy connected accounts, so connect your own | | **Secrets** | No | Connected accounts and secrets stay with the creator | -| **Taskade EVE memory** | No | The creator's Taskade EVE memory projects are not copied | -| **Media files** | Yes | Images, uploads | -| **Custom domain** | No | You'll need to configure your own | -| **Analytics data** | No | Fresh start with new metrics | -| **Passwords** | No | Set your own | +| **Taskade EVE memory** | No | Taskade does not copy the Taskade EVE memory projects of the creator | +| **Media files** | Yes | Images and uploads | +| **Custom domain** | No | Connect your own domain | +| **Analytics data** | No | Your copy starts with new metrics | +| **Passwords** | No | Set your own password | --- ## Prefilled Taskade Genesis Links -You can share a link that opens Taskade Genesis with an app description already filled in, so the recipient generates it in one click instead of retyping the idea. +You can share a link that opens Taskade Genesis with an app description in the prompt box. The recipient then builds the app with one click and does not type the idea again. **Link format:** @@ -153,58 +181,61 @@ You can share a link that opens Taskade Genesis with an app description already https://www.taskade.com/create?input=YOUR_APP_DESCRIPTION ``` -When opened, Taskade Genesis loads with the description pre-populated and ready to generate — the recipient can still edit it first. The `input` value is URL-encoded (a space becomes `%20`); most browsers encode it automatically when you copy the link back out of the address bar. +The link opens Taskade Genesis with the description in the prompt box. The recipient can edit the description first. The `input` value is URL-encoded (a space becomes `%20`). Most browsers encode it automatically when you copy the link from the address bar. {% hint style="info" %} -Specific descriptions produce better results: "Create a restaurant reservation system with table availability, guest preferences, and confirmation emails" works far better than "Build a booking app." Very long descriptions may hit browser URL-length limits. +A specific description gives better results. "Create a restaurant reservation system with table availability, guest preferences, and confirmation emails" works much better than "Build a booking app." A very long description can go over the URL length limit of a browser. {% endhint %} --- ## Paid Apps -Taskade Genesis lets creators sell original apps as paid App Kits. Buyers pay before receiving their own private copy. +With Taskade Genesis, creators can sell original apps as paid App Kits. Buyers pay first, then get their own private copy. ### How It Works | Step | What Happens | |---|---| -| **Creator sets a price** | In the app's **Publish** panel, open **Let others clone**, choose **Paid**, enter the price, and click **Put on sale**. Finish payout setup in **Earnings**. | -| **Buyer discovers the app** | The app appears in the Taskade App Factory (or via a direct link) with a price tag. | -| **Buyer pays via Stripe** | Checkout is handled by Stripe. No payment details are stored by Taskade. | -| **Buyer receives a private copy** | After successful payment, Taskade clones the app directly into the buyer's workspace. | +| **The creator sets a price** | In the **Publish** panel of the app, open **Let others clone**, choose **Paid**, type the price, and click **Put on sale**. Then finish the payout setup in **Earnings**. | +| **A buyer finds the app** | The app shows in the Taskade App Factory, or at a direct link, with a price tag. | +| **The buyer pays through Stripe** | Stripe runs the checkout. Taskade does not store payment details. | +| **The buyer gets a private copy** | After the payment, Taskade clones the app into the workspace of the buyer. | ### Key Rules for Paid App Copies | Rule | Detail | |---|---| -| **Scope** | Cloned paid apps are scoped to the buyer's workspace only. | -| **Re-selling** | Buyers can customize and publish their copy, but cannot sell it as their original work. | -| **Clone ancestry** | Taskade tracks clone lineage — each paid copy is linked to the original app and its creator. | -| **Payouts** | See **Earnings** for current payout terms. | +| **Scope** | A cloned paid app stays in the workspace of the buyer only. | +| **Re-selling** | Buyers can change and publish their copy. They cannot sell it as their original work. | +| **Clone ancestry** | Taskade links each paid copy to the original app and its creator. | +| **Sample rows** | When you check a project that also takes visitor rows, the kit ships your rows only. A row that a visitor, a form, or an automation adds after you checked the project stays out of every new kit version. | +| **Payouts** | Read **Earnings** for the current payout terms. | {% hint style="info" %} -Paid apps do not affect the buyer's ability to customize or extend the app within their own workspace. An app cloned from another creator cannot be sold as original work, which protects creator rights. +A paid app does not limit how the buyer changes or extends it in their own workspace. Nobody can sell an app that they cloned from another creator as original work. This rule protects the rights of creators. {% endhint %} --- ## Custom Domains -Connect your own domain to any published Genesis app: +Connect your own domain to a published Taskade Genesis app: | Feature | Detail | |---|---| | **Available on** | Pro (up to 10 per workspace), Business and up (unlimited) | -| **Setup method** | CNAME record pointing to `external.taskade.com`, plus a short SSL record Taskade gives you (or buy a domain inside Taskade) | +| **Setup method** | A CNAME record that points to `external.taskade.com`, plus a short SSL record that Taskade gives you. You can also buy a domain inside Taskade | | **SSL** | Automatic | -| **Configuration** | App settings → Launch → Domains | +| **Settings** | App settings → Launch → Domains | -1. Open **App settings** → **Launch** → **Domains** -2. Enter your custom domain (e.g., `app.yourcompany.com`) -3. Add the provided CNAME record (and the SSL record) to your DNS provider -4. Wait for DNS propagation (up to 48 hours) -5. SSL certificate is provisioned automatically +1. Open **App settings** → **Launch** → **Domains**. +2. Under **Connect a domain you own**, click **Connect**. +3. In **Your domain**, type your custom domain, for example `app.yourcompany.com`. +4. Add the CNAME record and the SSL record to your DNS provider. +5. Wait for DNS propagation. It can take up to 48 hours. + +Taskade then provisions the SSL certificate automatically. To buy a new domain instead, click **Shop domains** under **Buy a brand-new domain**. --- @@ -213,10 +244,10 @@ Connect your own domain to any published Genesis app: | Feature | Description | Plan | |---|---|---| | **Direct link** | Copy and share the app URL | All | -| **Embed** | Embed app in your website or blog via iframe | All | -| **Social sharing** | Share on LinkedIn, Twitter, Reddit, Facebook | All | -| **SEO customization** | Custom meta title, description, Open Graph image | Business+ | -| **Custom colors** | Branded app color theme | Business+ | +| **Embed** | Put the app in your website or blog with an iframe | All | +| **Social sharing** | Share on LinkedIn, Twitter, Reddit, or Facebook | All | +| **SEO settings** | Custom meta title, description, and Open Graph image | Business+ | +| **Custom colors** | A color theme for your brand | Business+ | | **Remove Taskade badge** | Hide the "Powered by Taskade" badge | All paid plans | | **App sign-in** | App Users sign in to your app ([GenesisAuth](genesis-auth.md)) | All | @@ -224,14 +255,14 @@ Connect your own domain to any published Genesis app: ## Embedding Your App -You can embed any published Genesis app into an external website, blog, or documentation page using an iframe. +You can put a published Taskade Genesis app into an external website, blog, or documentation page with an iframe. ### Getting the Embed Code 1. Open your published app in Taskade. 2. Click **Publish**. -3. Click the embed button (``) next to the app address, or **Copy Embed Code**. -4. Paste the `