docs: v4 beta internal docs

- Updated the main README to indicate that official documentation for package v4 is not yet available, directing users to the internal documentation for the v4 beta.
- Created a new README file in the src directory to provide detailed installation instructions and command references for the Storyblok CLI package.
- Added a comprehensive guide for the `login` command, including usage examples and options.

Author: alvarosabu

README.md

@@ -48,7 +48,10 @@
 
 ## Documentation
 
-For complete documentation, please visit [https://storyblok.com/docs](https://storyblok.com/docs/packages/my-joyful-package)
+> [!WARNING]
+> Official documentation about this package v4 is not yet available. Please refer to the internal documentation for the [v4 beta](src/README.md).
+
+~~For complete documentation, please visit [https://storyblok.com/docs](https://storyblok.com/docs/packages/my-joyful-package)~~
 
 ## Setup
 

src/README.md

@@ -0,0 +1,41 @@
+![Storyblok ImagoType](https://raw.githubusercontent.com/storyblok/.github/refs/heads/main/profile/public/github-banner.png)
+
+# Storyblok CLI Package Reference
+
+## Installation
+
+For the latest beta version, install the package using the following command:
+
+```bash
+npm install storyblok@beta
+```
+
+Or for an specific beta version:
+
+```bash
+npm install storyblok@4.0.0-beta.<version>
+```
+
+## Command Reference 
+
+| Command | Status | Notes |
+|---------|--------|-------|
+| [`login`](./commands/login/README.md) | ✅ Ready | Improved DX and credentials storage in ~/.storyblok/credentials.json |
+| `logout` | ✅ Ready | |
+| `user` | ✅ Ready | |
+| `languages pull` | ✅ Ready | Replaces previous pull-languages |
+| `components pull` | ✅ Ready | Replaces previous pull-components |
+| `components push` | ✅ Ready | Replaces previous push-components. Also handles dependencies such as groups, tags, presets and whitelists. (Datasources is pending) |
+| `components delete` | 📝 Planned | Will replace delete-component and delete-components |
+| `migrations generate` | ✅ Ready | Replaces previous generate-migrations |
+| `migrations run` | ✅ Ready | Replaces previous run-migrations |
+| `migrations rollback` | ✅ Ready | Replaces previous rollback-migrations |
+| `types generate` | ✅ Ready | Replaces previous generate-typescript-typedefs |
+| `sync` | ⚠️ v3 | |
+| `datasources pull` | 📝 Planned | |
+| `datasources push` | 📝 Planned | |
+| `datasources delete` | 📝 Planned | Will replace delete-datasources |
+| `select` | 💬 TBD | To be discussed |
+| `quickstart` | 💬 TBD | To be discussed |
+| `spaces` | 💬 TBD | To be discussed |
+| `import` | 💬 TBD | To be discussed |

src/commands/login/README.md

@@ -0,0 +1,57 @@
+# Login Command
+
+The `login` command allows you to authenticate with your Storyblok account. It supports multiple login methods and regions.
+
+## Basic Usage
+
+```bash
+storyblok login
+```
+
+This will start an interactive login process where you can choose between:
+- Email and password login
+- Token-based login (SSO)
+
+### Get your personal access token
+
+Go to https://app.storyblok.com/#/me/account?tab=token and click on **Generate new token**.
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-t, --token <token>` | Login directly with a token (useful for CI environments) | - |
+| `-r, --region <region>` | Set the region to work with (must match your space's region) | `eu` |
+
+## Examples
+
+1. Login with email and password:
+```bash
+storyblok login
+```
+
+2. Login with a token:
+```bash
+storyblok login --token PERSONAL_ACCESS_TOKEN
+```
+
+3. Login with a token in a specific region:
+```bash
+storyblok login --token PERSONAL_ACCESS_TOKEN --region us
+```
+
+## Notes
+
+- Credentials are stored securely in `~/.storyblok/credentials.json`
+- The region setting will be used for all subsequent CLI commands
+- If you're already logged in, you'll need to logout first to switch accounts
+- For CI environments, it's recommended to use the `--token` option
+- The CLI supports two-factor authentication (2FA) when using email login
+
+## Available Regions
+
+- `eu` - Europe
+- `us` - United States
+- `cn` - China
+- `au` - Australia
+