diff --git a/CLI_VERSION b/CLI_VERSION index 08692e0..a2588c5 100644 --- a/CLI_VERSION +++ b/CLI_VERSION @@ -1 +1 @@ -v0.0.26 +v0.0.29 diff --git a/skills/base44-cli/SKILL.md b/skills/base44-cli/SKILL.md index 549634b..560e9d4 100644 --- a/skills/base44-cli/SKILL.md +++ b/skills/base44-cli/SKILL.md @@ -188,7 +188,8 @@ npx base44 |---------|-------------|-----------| | `base44 create` | Create a new Base44 project from a template | [create.md](references/create.md) ⚠️ **MUST READ** | | `base44 link` | Link an existing local project to Base44 | [link.md](references/link.md) | -| `base44 dashboard` | Open the app dashboard in your browser | [dashboard.md](references/dashboard.md) | +| `base44 dashboard` | Manage dashboard access | [dashboard.md](references/dashboard.md) | +| `base44 dashboard open` | Open the app dashboard in your browser | [dashboard-open.md](references/dashboard-open.md) | ### Deployment @@ -245,6 +246,7 @@ Agents are conversational AI assistants that can interact with users, access you | Action / Command | Description | Reference | | ----------------------- | --------------------------------------- | ----------------------------------------------- | +| `base44 agents` | Manage agent configurations | [agents.md](references/agents.md) | | Create Agents | Define agents in `base44/agents` folder | See Agent Schema below | | `base44 agents pull` | Pull remote agents to local files | [agents-pull.md](references/agents-pull.md) | | `base44 agents push` | Push local agents to Base44 | [agents-push.md](references/agents-push.md) | @@ -287,10 +289,21 @@ Agents are conversational AI assistants that can interact with users, access you | Command | Description | Reference | | -------------------- | ----------------------------------------- | ------------------------------------------- | +| `base44 site` | Manage site deployment and access | [site.md](references/site.md) | | `base44 site deploy` | Deploy built site files to Base44 hosting | [site-deploy.md](references/site-deploy.md) | +| `base44 site open` | Open the published site in your browser | [site-open.md](references/site-open.md) | **SPA only**: Base44 hosting supports Single Page Applications with a single `index.html` entry point. All routes are served from `index.html` (client-side routing). +### Type Generation + +| Command | Description | Reference | +| ------------------------- | ------------------------------------------------ | --------------------------------------------------- | +| `base44 types` | Manage TypeScript type generation | [types.md](references/types.md) | +| `base44 types generate` | Generate TypeScript types from project resources | [types-generate.md](references/types-generate.md) | + +**Note:** Type generation creates TypeScript definitions from your entities, functions, and agents, automatically updating your `tsconfig.json` for type-safe development. + ## Quick Start 1. Install the CLI in your project: @@ -364,7 +377,7 @@ npx base44 site deploy -y ### Opening the Dashboard ```bash # Open app dashboard in browser -npx base44 dashboard +npx base44 dashboard open ``` ## Authentication diff --git a/skills/base44-cli/references/agents.md b/skills/base44-cli/references/agents.md new file mode 100644 index 0000000..dd7c95a --- /dev/null +++ b/skills/base44-cli/references/agents.md @@ -0,0 +1,26 @@ +# base44 agents + +Manage project agents. + +## Syntax + +```bash +npx base44 agents +``` + +## Subcommands + +| Command | Description | +|---------|-------------| +| `pull` | Pull agents from Base44 to local files | +| `push` | Push local agents to Base44 | + +## Authentication + +**Required**: Yes (for all subcommands) + +## Notes + +- This is a parent command - you must use a subcommand +- See individual subcommand documentation for details +- Agents are conversational AI assistants that can interact with users, access your app's entities, and call backend functions diff --git a/skills/base44-cli/references/dashboard-open.md b/skills/base44-cli/references/dashboard-open.md new file mode 100644 index 0000000..a20d6a4 --- /dev/null +++ b/skills/base44-cli/references/dashboard-open.md @@ -0,0 +1,37 @@ +# base44 dashboard open + +Opens the Base44 app dashboard in your default web browser. + +## Syntax + +```bash +npx base44 dashboard open +``` + +## Options + +This command has no options. + +## What It Does + +1. Reads the project's app ID from `base44/.app.jsonc` +2. Opens the dashboard URL in your default browser +3. Skips opening the browser in CI environments (checks `CI` environment variable) + +## Example + +```bash +# Open dashboard for current project +npx base44 dashboard open +``` + +## Requirements + +- Must be run from a linked Base44 project directory (contains `base44/.app.jsonc`) +- Must be authenticated (run `npx base44 login` first) + +## Notes + +- The dashboard provides a web interface to manage your app's entities, functions, users, and settings +- If you're not in a project directory, the command will fail with an error +- The browser will not open automatically in CI environments diff --git a/skills/base44-cli/references/dashboard.md b/skills/base44-cli/references/dashboard.md index 95a534a..bb9b94d 100644 --- a/skills/base44-cli/references/dashboard.md +++ b/skills/base44-cli/references/dashboard.md @@ -1,35 +1,24 @@ # base44 dashboard -Opens the Base44 app dashboard in your default web browser. +Manage app dashboard. ## Syntax ```bash -npx base44 dashboard +npx base44 dashboard ``` -## Options +## Subcommands -This command has no options. +| Command | Description | +|---------|-------------| +| `open` | Open the app dashboard in your browser | -## What It Does +## Authentication -1. Reads the project's app ID from `base44/.app.jsonc` -2. Opens the dashboard URL in your default browser - -## Example - -```bash -# Open dashboard for current project -npx base44 dashboard -``` - -## Requirements - -- Must be run from a linked Base44 project directory (contains `base44/.app.jsonc`) -- Must be authenticated (run `npx base44 login` first) +**Required**: Yes (for all subcommands) ## Notes -- The dashboard provides a web interface to manage your app's entities, functions, users, and settings -- If you're not in a project directory, the command will fail with an error +- This is a parent command - you must use a subcommand +- See individual subcommand documentation for details diff --git a/skills/base44-cli/references/site-open.md b/skills/base44-cli/references/site-open.md new file mode 100644 index 0000000..a1d843f --- /dev/null +++ b/skills/base44-cli/references/site-open.md @@ -0,0 +1,46 @@ +# base44 site open + +Open the published site in your default web browser. + +## Syntax + +```bash +npx base44 site open +``` + +## Authentication + +**Required**: Yes. If not authenticated, you'll be prompted to login first. + +## What It Does + +1. Fetches the site URL for the current project +2. Opens the site URL in your default browser +3. Skips opening the browser in CI environments (checks `CI` environment variable) + +## Example + +```bash +# Open the published site +npx base44 site open +``` + +## Requirements + +- Must be run from a linked Base44 project directory (contains `base44/.app.jsonc`) +- Must be authenticated (run `npx base44 login` first) +- Site must be deployed (use `npx base44 site deploy` first) + +## Output + +```bash +$ npx base44 site open + +Site opened at https://my-app.base44.app +``` + +## Notes + +- This opens the publicly accessible URL of your deployed site +- The browser will not open automatically in CI environments +- Use `npx base44 dashboard open` to access the management dashboard instead diff --git a/skills/base44-cli/references/site.md b/skills/base44-cli/references/site.md new file mode 100644 index 0000000..acf0e48 --- /dev/null +++ b/skills/base44-cli/references/site.md @@ -0,0 +1,26 @@ +# base44 site + +Manage app site (frontend app). + +## Syntax + +```bash +npx base44 site +``` + +## Subcommands + +| Command | Description | +|---------|-------------| +| `deploy` | Deploy built site files to Base44 hosting | +| `open` | Open the published site in your browser | + +## Authentication + +**Required**: Yes (for all subcommands) + +## Notes + +- This is a parent command - you must use a subcommand +- See individual subcommand documentation for details +- The site refers to your frontend application (React, Vue, etc.) diff --git a/skills/base44-cli/references/types-generate.md b/skills/base44-cli/references/types-generate.md new file mode 100644 index 0000000..b128f50 --- /dev/null +++ b/skills/base44-cli/references/types-generate.md @@ -0,0 +1,81 @@ +# base44 types generate + +Generate TypeScript declaration file (types.d.ts) from project resources. + +## Syntax + +```bash +npx base44 types generate +``` + +## Authentication + +**Required**: No (type generation is a local operation) + +## What It Does + +1. Reads project configuration and resources (entities, functions, agents) +2. Generates TypeScript type definitions based on your project resources +3. Writes the types to `base44/.types/types.d.ts` +4. Updates `tsconfig.json` to include the generated types (if tsconfig.json exists) + +## Prerequisites + +- Must be run from a Base44 project directory +- Project must have `base44/config.jsonc` configuration file + +## Output + +```bash +$ npx base44 types generate + +Generating types... +✓ Types generated + +Generated base44/.types/types.d.ts and updated tsconfig.json +``` + +If no `tsconfig.json` is found: +```bash +$ npx base44 types generate + +Generating types... +✓ Types generated + +Generated base44/.types/types.d.ts +``` + +## What Gets Generated + +The generated types file includes TypeScript definitions for: + +- **Entities**: Type definitions matching your entity schemas +- **Functions**: Function signatures for your backend functions +- **Agents**: Agent configuration types + +## Use Cases + +- After creating or modifying entities to get updated types +- Setting up TypeScript in your project for the first time +- Getting IntelliSense and autocomplete for your Base44 resources +- Ensuring type safety when working with entities and functions + +## TypeScript Configuration + +If a `tsconfig.json` file exists in your project root, the command will automatically add the types path to the `include` array: + +```json +{ + "include": [ + "src", + "base44/.types/types.d.ts" + ] +} +``` + +## Notes + +- This is a local operation - it doesn't require authentication or network access +- The generated file is created in `base44/.types/types.d.ts` +- Re-run this command whenever you change your entity schemas, functions, or agents +- The types file should not be edited manually - it will be overwritten on next generation diff --git a/skills/base44-cli/references/types.md b/skills/base44-cli/references/types.md new file mode 100644 index 0000000..6fe687a --- /dev/null +++ b/skills/base44-cli/references/types.md @@ -0,0 +1,25 @@ +# base44 types + +Manage TypeScript type generation. + +## Syntax + +```bash +npx base44 types +``` + +## Subcommands + +| Command | Description | +|---------|-------------| +| `generate` | Generate TypeScript declaration file from project resources | + +## Authentication + +**Required**: No (type generation is a local operation) + +## Notes + +- This is a parent command - you must use a subcommand +- See individual subcommand documentation for details +- Type generation helps provide IntelliSense and type safety when working with Base44 entities, functions, and agents