Skip to content
Closed
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
2 changes: 1 addition & 1 deletion CLI_VERSION
Original file line number Diff line number Diff line change
@@ -1 +1 @@
v0.0.26
v0.0.30
15 changes: 12 additions & 3 deletions skills/base44-cli/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -188,7 +188,7 @@ npx base44 <command>
|---------|-------------|-----------|
| `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 open` | Open the app dashboard in your browser | [dashboard.md](references/dashboard.md) |

### Deployment

Expand Down Expand Up @@ -263,7 +263,7 @@ Agents are conversational AI assistants that can interact with users, access you
"instructions": "Detailed instructions for the agent's behavior",
"tool_configs": [
// Entity tool - gives agent access to entity operations
{ "entity_name": "tasks", "allowed_operations": ["read", "create", "update", "delete"] },
{ "entity_name": "Task", "allowed_operations": ["read", "create", "update", "delete"] },
// Backend function tool - gives agent access to a function
{ "function_name": "send_email", "description": "Send an email notification" }
],
Expand All @@ -288,9 +288,18 @@ Agents are conversational AI assistants that can interact with users, access you
| Command | Description | Reference |
| -------------------- | ----------------------------------------- | ------------------------------------------- |
| `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 generate` | Generate TypeScript types from project resources | [types-generate.md](references/types-generate.md) |

**Note:** This command is hidden in the CLI help menu and is for advanced usage. It generates TypeScript declaration files from entities, functions, and agents.

## Quick Start

1. Install the CLI in your project:
Expand Down Expand Up @@ -364,7 +373,7 @@ npx base44 site deploy -y
### Opening the Dashboard
```bash
# Open app dashboard in browser
npx base44 dashboard
npx base44 dashboard open
```

## Authentication
Expand Down
6 changes: 3 additions & 3 deletions skills/base44-cli/references/dashboard.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
# base44 dashboard
# base44 dashboard open

Opens the Base44 app dashboard in your default web browser.

## Syntax

```bash
npx base44 dashboard
npx base44 dashboard open
```

## Options
Expand All @@ -21,7 +21,7 @@ This command has no options.

```bash
# Open dashboard for current project
npx base44 dashboard
npx base44 dashboard open
```

## Requirements
Expand Down
52 changes: 52 additions & 0 deletions skills/base44-cli/references/site-open.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
# 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 your Base44 app
2. Opens the site in your default browser

## Prerequisites

- Must be run from a linked Base44 project directory
- Must be authenticated (run `npx base44 login` first)
- Site must have been deployed previously

## Output

```bash
$ npx base44 site open

Site opened at https://my-app.base44.app
```

## Use Cases

- Quickly preview your deployed site
- Open your site from the command line
- Check the live version after deployment

## Notes

- The command opens the current live version of your site
- In CI environments (when `CI` env var is set), the browser won't open but the URL is displayed
- The site URL is the same as the one shown after `base44 site deploy`

## Related Commands

| Command | Description |
|---------|-------------|
| `base44 site deploy` | Deploy built site files to Base44 hosting |
| `base44 dashboard open` | Open the app dashboard in your browser |
| `base44 deploy` | Deploy all resources including the site |
78 changes: 78 additions & 0 deletions skills/base44-cli/references/types-generate.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,78 @@
# base44 types generate

Generate TypeScript declaration file (types.d.ts) from project resources (entities, functions, and agents).

## Syntax

```bash
npx base44 types generate
```

## Authentication

**Required**: No. This command operates on local files only.

## What It Does

1. Reads project configuration from `base44/config.jsonc`
2. Reads all entities, functions, and agents from the project
3. Generates TypeScript type definitions in `base44/.types/types.d.ts`
4. Updates `tsconfig.json` to include the generated types (if tsconfig exists)

## Prerequisites

- Must be run from a Base44 project directory
- Project must have `base44/config.jsonc`

## Output

```bash
$ npx base44 types generate

Generating types...
✓ Types generated successfully

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 successfully

Generated base44/.types/types.d.ts
```

## Generated Types

The command generates TypeScript type definitions for:

- **Entity types** - TypeScript interfaces for each entity schema
- **Function types** - Type definitions for backend functions
- **Agent types** - Type definitions for agent configurations

## Use Cases

- After creating or modifying entities
- After adding or changing functions
- After modifying agent configurations
- To get TypeScript IntelliSense for Base44 resources
- As part of your development workflow

## Notes

- This command is hidden in the CLI help menu (internal/advanced usage)
- The generated types file is located at `base44/.types/types.d.ts`
- If `tsconfig.json` exists, it will be automatically updated to include the types
- Re-run this command whenever you modify entity schemas, functions, or agents
- The command does not require authentication or network access

## Related Commands

| Command | Description |
|---------|-------------|
| `base44 entities push` | Push entities to Base44 (triggers remote type generation) |
| `base44 functions deploy` | Deploy functions to Base44 |
| `base44 agents push` | Push agents to Base44 |
Loading