Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 25 additions & 23 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,22 +6,23 @@

## What is Workspace DNA?

Every Taskade workspace is built from four types of DNA:
Workspace DNA has three parts: Memory, Intelligence and Execution. The app interface sits on top of them:

| Layer | Folder | What it does |
|-------|--------|-------------|
| **Memory** | `projects/` | Structured data — task trees, checklists, notes |
| **Intelligence** | `agents/` | AI agents with custom commands and personas |
| **Reflexes** | `automations/` | Trigger-action workflows connecting services |
| **Interface** | `apps/` | Genesis app UI — React components via Parade engine |
| **Execution** | `automations/` | Trigger-action workflows connecting services |
| **Interface** | `apps/` | Taskade Genesis app UI — React components that the app engine runs |

This repo contains one JSON file per DNA item — the same format that Taskade uses internally. No build toolchain required to understand or edit.
This repo contains one JSON file per DNA item — the same format that the Taskade bundle import and export API uses. No build toolchain required to understand or edit.

## Quick Start

```bash
# 1. Fork this repo (or click "Use this template")
gh repo fork taskade/taskade-sample-app
gh repo fork taskade/taskade-sample-app --clone
cd taskade-sample-app

# 2. Install dependencies
npm install
Expand Down Expand Up @@ -54,31 +55,32 @@ taskade-sample-app/
│ ├── getting-started.json # Onboarding checklist
│ └── roadmap.json # Product roadmap with phases
├── apps/
│ └── hello-world.json # Sample Genesis app (React + Tailwind)
│ └── hello-world.json # Sample Taskade Genesis app (React + Tailwind)
├── media/
│ └── icon.svg # App icon
├── scripts/
│ ├── assemble.ts # Combines folders → workspace.json
│ ├── validate.ts # Validates against SpaceBundleData schema
│ └── import.ts # Uploads to Taskade via API
│ ├── import.ts # Uploads to Taskade via API
│ └── export.ts # Downloads a workspace via API
└── dist/ # (generated) assembled bundle
└── workspace.json
```

## How It Maps to Taskade

The folder structure mirrors the Workspace tab in Taskade:
Each folder maps to one part of a Taskade workspace:

```
GitHub Repo Taskade Workspace Tab
═══════════ ═════════════════════
agents/*.json ──► [Agents] filter pill
automations/*.json ──► [Automations] filter pill
projects/*.json ──► [Projects] filter pill
apps/*.json ──► [Apps] Genesis app UI
GitHub Repo Taskade Workspace
═══════════ ═════════════════
agents/*.json ──► AI agents
automations/*.json ──► Automations
projects/*.json ──► Projects
apps/*.json ──► Taskade Genesis app UI
```

Each JSON file is the same data shape that Taskade's internal `SpaceBundleData` uses. You can:
Each JSON file is the same data shape that the Taskade bundle API uses (`SpaceBundleData` v1). You can:
- **Export** a workspace from Taskade → get these JSON files
- **Edit** the JSON files in any editor
- **Import** back into Taskade → get a working workspace
Expand All @@ -87,7 +89,7 @@ Each JSON file is the same data shape that Taskade's internal `SpaceBundleData`

| Command | What it does |
|---------|-------------|
| `npm run export` | Pull a workspace into local JSON files |
| `npm run export` | Pull a workspace into local JSON files (bundle export needs the Pro plan or higher, see [pricing](https://www.taskade.com/pricing)) |
| `npm run validate` | Validates all JSON files against Taskade schemas |
| `npm run assemble` | Combines all items into `dist/workspace.json` |
| `npm run build` | Assemble + validate (both steps) |
Expand Down Expand Up @@ -129,7 +131,7 @@ Each JSON file is the same data shape that Taskade's internal `SpaceBundleData`
}
```

4. **Add a Genesis app**: Create `apps/my-app.json` with a `FileSystemTree`:
4. **Add a Taskade Genesis app**: Create `apps/my-app.json` with a `FileSystemTree`:
```json
{
"src": {
Expand All @@ -143,17 +145,17 @@ Each JSON file is the same data shape that Taskade's internal `SpaceBundleData`
}
}
```
The file system tree mirrors the Parade base template structure. Each file node has `{ file: { contents: "..." } }` and directories use `{ directory: { ... } }`.
The file system tree mirrors the file structure of a Taskade Genesis app. Each file node has `{ file: { contents: "..." } }` and directories use `{ directory: { ... } }`.

5. Run `npm run build` to assemble and validate.

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `TASKADE_API_TOKEN` | For import | Personal Access Token (`tskdp_...`) |
| `TASKADE_WORKSPACE_ID` | For import | Target workspace ID |
| `TASKADE_API_URL` | No | API base URL (default: `https://taskade.com`) |
| `TASKADE_API_TOKEN` | For import and export | Personal Access Token (`tskdp_...`) |
| `TASKADE_WORKSPACE_ID` | For import and export | Target or source workspace ID |
| `TASKADE_API_URL` | No | API base URL (default: `https://www.taskade.com`) |

Get your API token at [taskade.com/settings/api](https://www.taskade.com/settings/api).

Expand All @@ -162,8 +164,8 @@ Get your API token at [taskade.com/settings/api](https://www.taskade.com/setting
- [Build an app with Taskade Genesis](https://www.taskade.com/create)
- [AI app builder](https://www.taskade.com/ai/apps)
- [AI agents](https://www.taskade.com/ai/agents)
- [Community apps you can clone](https://www.taskade.com/apps)
- [Hosted MCP server](https://www.taskade.com/mcp)
- [Taskade App Factory: App Kits you can clone](https://www.taskade.com/apps)
- [Hosted MCP server](https://www.taskade.com/docs/mcp/hosted-mcp) at `https://www.taskade.com/mcp`, part of every paid plan
- [Taskade API Docs](https://www.taskade.com/api/documentation/v1)
- [Taskade MCP Server on GitHub](https://github.com/taskade/mcp)

Expand Down
2 changes: 1 addition & 1 deletion apps/hello-world.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
"directory": {
"App.tsx": {
"file": {
"contents": "import * as React from 'react';\nimport { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card';\nimport { Button } from '@/components/ui/button';\nimport { Badge } from '@/components/ui/badge';\n\nexport default function App() {\n const [count, setCount] = React.useState(0);\n\n return (\n <div className=\"min-h-screen bg-background p-8\">\n <div className=\"mx-auto max-w-2xl space-y-6\">\n <Card>\n <CardHeader>\n <CardTitle className=\"text-2xl\">Hello World</CardTitle>\n <CardDescription>\n A sample Genesis app built with Workspace DNA.\n </CardDescription>\n </CardHeader>\n <CardContent className=\"space-y-4\">\n <div className=\"flex items-center gap-3\">\n <Button onClick={() => setCount((c) => c + 1)}>\n Count: {count}\n </Button>\n <Badge variant=\"secondary\">Genesis App</Badge>\n </div>\n <p className=\"text-sm text-muted-foreground\">\n This app was assembled from the taskade-sample-app template.\n Edit <code>apps/hello-world.json</code> to customize it.\n </p>\n </CardContent>\n </Card>\n </div>\n </div>\n );\n}\n"
"contents": "import * as React from 'react';\nimport { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card';\nimport { Button } from '@/components/ui/button';\nimport { Badge } from '@/components/ui/badge';\n\nexport default function App() {\n const [count, setCount] = React.useState(0);\n\n return (\n <div className=\"min-h-screen bg-background p-8\">\n <div className=\"mx-auto max-w-2xl space-y-6\">\n <Card>\n <CardHeader>\n <CardTitle className=\"text-2xl\">Hello World</CardTitle>\n <CardDescription>\n A sample Taskade Genesis app built with Workspace DNA.\n </CardDescription>\n </CardHeader>\n <CardContent className=\"space-y-4\">\n <div className=\"flex items-center gap-3\">\n <Button onClick={() => setCount((c) => c + 1)}>\n Count: {count}\n </Button>\n <Badge variant=\"secondary\">Taskade Genesis App</Badge>\n </div>\n <p className=\"text-sm text-muted-foreground\">\n This app was assembled from the taskade-sample-app template.\n Edit <code>apps/hello-world.json</code> to customize it.\n </p>\n </CardContent>\n </Card>\n </div>\n </div>\n );\n}\n"
}
},
"main.tsx": {
Expand Down
2 changes: 1 addition & 1 deletion manifest.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
"name": "Taskade Sample App",
"version": "1.0.0",
"author": "taskade",
"description": "A sample Genesis app demonstrating Workspace DNA: agents, automations, and projects working together.",
"description": "A sample Taskade Genesis app demonstrating Workspace DNA: agents, automations, and projects working together.",
"tags": ["sample", "getting-started", "genesis"],
"icon": "media/icon.svg",
"minPlatformVersion": "2025.1"
Expand Down
2 changes: 1 addition & 1 deletion projects/getting-started.json
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@
"id": "overview-desc",
"text": {
"ops": [
{ "insert": "This project is part of a sample Genesis app. It demonstrates how Projects (Memory), Agents (Intelligence), and Automations (Reflexes) work together as Workspace DNA." },
{ "insert": "This project is part of a sample Taskade Genesis app. It demonstrates how Projects (Memory), Agents (Intelligence), and Automations (Execution) work together as Workspace DNA." },
{ "insert": "\n", "attributes": { "paragraph": true } }
]
},
Expand Down
2 changes: 1 addition & 1 deletion projects/roadmap.json
Original file line number Diff line number Diff line change
Expand Up @@ -77,7 +77,7 @@
"id": "task-p2-1",
"text": {
"ops": [
{ "insert": "Publish to community gallery" },
{ "insert": "Publish to Taskade App Factory" },
{ "insert": "\n", "attributes": { "paragraph": true } }
]
},
Expand Down
2 changes: 1 addition & 1 deletion scripts/assemble.ts
Original file line number Diff line number Diff line change
Expand Up @@ -86,7 +86,7 @@ for (const { name, data } of readJsonFiles('projects')) {
};
}

// Apps (Genesis app file systems)
// Apps (Taskade Genesis app file systems)
for (const { name, data } of readJsonFiles('apps')) {
const id = `app-${name}`;
items[id] = {
Expand Down
4 changes: 2 additions & 2 deletions scripts/export.ts
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ import * as fs from 'node:fs';
import * as path from 'node:path';

const ROOT = path.resolve(import.meta.dirname, '..');
const API_BASE = process.env.TASKADE_API_URL ?? 'https://taskade.com';
const API_BASE = process.env.TASKADE_API_URL ?? 'https://www.taskade.com';
const API_TOKEN = process.env.TASKADE_API_TOKEN;
const WORKSPACE_ID = process.env.TASKADE_WORKSPACE_ID;

Expand All @@ -26,7 +26,7 @@ if (!API_TOKEN) {

if (!WORKSPACE_ID) {
console.error('Error: TASKADE_WORKSPACE_ID environment variable is required.');
console.error('Find your workspace ID in the workspace URL: https://taskade.com/ws/<workspace-id>');
console.error('Find your workspace ID in the workspace URL: https://www.taskade.com/spaces/<workspace-id>');
process.exit(1);
}

Expand Down
4 changes: 2 additions & 2 deletions scripts/import.ts
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ import * as fs from 'node:fs';
import * as path from 'node:path';

const ROOT = path.resolve(import.meta.dirname, '..');
const API_BASE = process.env.TASKADE_API_URL ?? 'https://taskade.com';
const API_BASE = process.env.TASKADE_API_URL ?? 'https://www.taskade.com';
const API_TOKEN = process.env.TASKADE_API_TOKEN;
const WORKSPACE_ID = process.env.TASKADE_WORKSPACE_ID;

Expand All @@ -27,7 +27,7 @@ if (!API_TOKEN) {

if (!WORKSPACE_ID) {
console.error('Error: TASKADE_WORKSPACE_ID environment variable is required.');
console.error('Find your workspace ID in the workspace URL: https://taskade.com/ws/<workspace-id>');
console.error('Find your workspace ID in the workspace URL: https://www.taskade.com/spaces/<workspace-id>');
process.exit(1);
}

Expand Down
Loading