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.29
17 changes: 15 additions & 2 deletions skills/base44-cli/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -188,7 +188,8 @@ 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` | 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

Expand Down Expand Up @@ -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) |
Expand Down Expand Up @@ -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:
Expand Down Expand Up @@ -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
Expand Down
26 changes: 26 additions & 0 deletions skills/base44-cli/references/agents.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
# base44 agents

Manage project agents.

## Syntax

```bash
npx base44 agents <command>
```

## 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
37 changes: 37 additions & 0 deletions skills/base44-cli/references/dashboard-open.md
Original file line number Diff line number Diff line change
@@ -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
31 changes: 10 additions & 21 deletions skills/base44-cli/references/dashboard.md
Original file line number Diff line number Diff line change
@@ -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 <command>
```

## 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
46 changes: 46 additions & 0 deletions skills/base44-cli/references/site-open.md
Original file line number Diff line number Diff line change
@@ -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
26 changes: 26 additions & 0 deletions skills/base44-cli/references/site.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
# base44 site

Manage app site (frontend app).

## Syntax

```bash
npx base44 site <command>
```

## 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.)
81 changes: 81 additions & 0 deletions skills/base44-cli/references/types-generate.md
Original file line number Diff line number Diff line change
@@ -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
25 changes: 25 additions & 0 deletions skills/base44-cli/references/types.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# base44 types

Manage TypeScript type generation.

## Syntax

```bash
npx base44 types <command>
```

## 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
Loading