Skip to content
Open
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.50
v0.0.51
9 changes: 8 additions & 1 deletion skills/base44-cli/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ description: "The base44 CLI is used for EVERYTHING related to base44 projects:
metadata:
sourcePackage:
name: base44
version: 0.0.50
version: 0.0.51
---

# Base44 CLI
Expand Down Expand Up @@ -210,6 +210,12 @@ npx base44 <command>
|---------|-------------|-----------|
| `base44 deploy` | Deploy all resources (entities, functions, agents, connectors, auth config, and site) | [deploy.md](references/deploy.md) |

### Local Development

| Command | Description | Reference |
|---------|-------------|-----------|
| `base44 dev` | Start the local development server | [dev.md](references/dev.md) |

### Entity Management

| Action / Command | Description | Reference |
Expand Down Expand Up @@ -361,6 +367,7 @@ Manage your app's authentication settings (e.g., username & password login). Aut
| Command | Description | Reference |
|---------|-------------|-----------|
| `base44 auth password-login <enable\|disable>` | Enable or disable username & password authentication | [auth-password-login.md](references/auth-password-login.md) |
| `base44 auth social-login <provider> <action>` | Enable or disable social login providers (google, microsoft, facebook, apple) | [auth-social-login.md](references/auth-social-login.md) |
| `base44 auth pull` | Pull auth config from Base44 to local files | [auth-pull.md](references/auth-pull.md) |
| `base44 auth push` | Push local auth config to Base44 | [auth-push.md](references/auth-push.md) |

Expand Down
53 changes: 53 additions & 0 deletions skills/base44-cli/references/auth-social-login.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
# base44 auth social-login

Enable or disable social login providers for your Base44 app.

## Syntax

```bash
npx base44 auth social-login <provider> <action> [options]
```

## Arguments

| Argument | Description | Required |
|----------|-------------|----------|
| `<provider>` | Social login provider: `google`, `microsoft`, `facebook`, `apple` | Yes |
| `<action>` | `enable` or `disable` the provider | Yes |

## Options

| Option | Description | Required |
|--------|-------------|----------|
| `--client-id <id>` | Custom OAuth client ID (Google only) | No |
| `--client-secret <secret>` | Custom OAuth client secret (Google only) | No |
| `--client-secret-stdin` | Read client secret from stdin (Google only) | No |
| `--env-file <path>` | Read client secret from a `.env` file (Google only) | No |

## Examples

```bash
# Enable Google login (using Base44's shared OAuth app)
npx base44 auth social-login google enable

# Disable Microsoft login
npx base44 auth social-login microsoft disable

# Enable Google login with a custom OAuth app
npx base44 auth social-login google enable --client-id my-client-id --client-secret my-secret

# Enable Google login, reading client secret from stdin
echo "my-secret" | npx base44 auth social-login google enable --client-id my-client-id --client-secret-stdin

# Enable Google login, reading client secret from a .env file
npx base44 auth social-login google enable --client-id my-client-id --env-file .env.secrets
```

## Notes

- Updates the local auth config file only — run `npx base44 auth push` or `npx base44 deploy` to apply the change to Base44.
- Custom OAuth options (`--client-id`, `--client-secret`, etc.) are only supported for Google. Microsoft, Facebook, and Apple use Base44's shared OAuth app.
- `--client-id` is required when providing any secret option.
- When providing a `--client-id` without a secret, the command will save the client ID locally. Push the secret separately: `npx base44 secrets set --env-file <path>`.
- Disabling a provider when no other login methods are enabled will warn you that users will be locked out.
- Client secret resolution order: stdin (`--client-secret-stdin`) > flag (`--client-secret`) > environment variable (`google_oauth_client_secret`) > interactive prompt.
33 changes: 33 additions & 0 deletions skills/base44-cli/references/dev.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# base44 dev

Start the local development server for your Base44 app.

## Syntax

```bash
npx base44 dev [options]
```

## Options

| Option | Description | Required |
|--------|-------------|----------|
| `-p, --port <number>` | Port for the development server | No |

## Examples

```bash
# Start the dev server on the default port
npx base44 dev

# Start the dev server on a specific port
npx base44 dev --port 3001
npx base44 dev -p 3001
```

## Notes

- The dev server emulates Base44's backend locally, including entity CRUD, backend functions, and auth endpoints.
- If no port is specified, the server selects an available port automatically and prints the URL on startup.
- Analytics tracking calls are silently proxied to production (not logged as warnings) to keep logs readable.
- Requests for endpoints not supported locally are proxied to the Base44 production API.
Loading