Skip to content

Automate browser based workflows with AI

docs: Multiple fixes for documentation site (#5379)

Kunal Mishra0d142cb3485c
diff --git a/docs/changelog.mdx b/docs/changelog.mdx
index 0c734a42c..baa67ec01 100644
--- a/docs/changelog.mdx
+++ b/docs/changelog.mdx
@@ -7,12 +7,12 @@ mode: custom
<div className="cl-page">
<div className="cl-sidebar">
<p className="cl-sidebar-title">TIMELINE</p>
- <a href="#v1022--february-26-2026" className="cl-sidebar-link">v1.0.22 — Feb 26, 2026</a>
- <a href="#v1021--february-24-2026" className="cl-sidebar-link">v1.0.21 — Feb 24, 2026</a>
- <a href="#v1018--february-19-2026" className="cl-sidebar-link">v1.0.18 — Feb 19, 2026</a>
- <a href="#v1017--february-19-2026" className="cl-sidebar-link">v1.0.17 — Feb 19, 2026</a>
- <a href="#v1016--february-19-2026" className="cl-sidebar-link">v1.0.16 — Feb 19, 2026</a>
- <a href="#v1015--february-17-2026" className="cl-sidebar-link">v1.0.15 — Feb 17, 2026</a>
+ <a href="#v1-0-22-—-february-26%2C-2026" className="cl-sidebar-link">v1.0.22 — Feb 26, 2026</a>
+ <a href="#v1-0-21-—-february-24%2C-2026" className="cl-sidebar-link">v1.0.21 — Feb 24, 2026</a>
+ <a href="#v1-0-18-—-february-19%2C-2026" className="cl-sidebar-link">v1.0.18 — Feb 19, 2026</a>
+ <a href="#v1-0-17-—-february-19%2C-2026" className="cl-sidebar-link">v1.0.17 — Feb 19, 2026</a>
+ <a href="#v1-0-16-—-february-19%2C-2026" className="cl-sidebar-link">v1.0.16 — Feb 19, 2026</a>
+ <a href="#v1-0-15-—-february-17%2C-2026" className="cl-sidebar-link">v1.0.15 — Feb 17, 2026</a>
</div>
<div className="cl-content">
diff --git a/docs/credentials/handle-2fa.mdx b/docs/credentials/handle-2fa.mdx
new file mode 100644
index 000000000..bcb17146d
--- /dev/null
+++ b/docs/credentials/handle-2fa.mdx
@@ -0,0 +1,504 @@
+---
+title: Handle 2FA
+subtitle: Configure two-factor authentication for automated logins
+slug: credentials/handle-2fa
+---
+
+Many websites require two-factor authentication (2FA) during login. Skyvern supports multiple 2FA methods to handle these flows automatically.
+
+---
+
+## Choose your method
+
+Select the method that matches how you receive verification codes:
+
+| Scenario | Recommended Method |
+|----------|-------------------|
+| You have the TOTP secret key | [Store TOTP secret](#method-1-store-totp-secret) — Skyvern generates codes |
+| Codes sent to email/SMS you can forward | [Push codes to Skyvern](#method-2-push-codes-to-skyvern) |
+| Codes sent to a system you control | [Skyvern pulls from your endpoint](#method-3-skyvern-pulls-from-your-endpoint) |
+| Passwordless/magic link auth | [Magic links](#method-4-magic-links) |
+| Using Bitwarden with TOTP | [Password manager integration](#password-manager-totp) |
+
+---
+
+## Method 1: Store TOTP secret
+
+**Best for:** Sites where you have access to the TOTP secret (the setup QR code or manual key).
+
+When you enable 2FA on a website, you're typically shown a QR code or a secret key. Store this secret with your credential, and Skyvern generates valid codes automatically.
+
+<CodeGroup>
+```python Python
+import os
+from skyvern import Skyvern
+
+client = Skyvern(api_key=os.getenv("SKYVERN_API_KEY"))
+
+credential = await client.create_credential(
+ name="Acme Portal Login",
+ credential_type="password",
+ credential={
+ "username": "[email protected]",
+ "password": "secure_password",
+ "totp": "JBSWY3DPEHPK3PXP", # Base32 secret from QR code
+ "totp_type": "authenticator",
+ },
+)
+```
+
+```typescript TypeScript
+import { SkyvernClient } from "@skyvern/client";
+
+const client = new SkyvernClient({
+ apiKey: process.env.SKYVERN_API_KEY,
+});
+
+const credential = await client.createCredential({
+ name: "Acme Portal Login",
+ credential_type: "password",
+ credential: {
+ username: "[email protected]",
+ password: "secure_password",
+ totp: "JBSWY3DPEHPK3PXP",
+ totp_type: "authenticator",
+ },
+});
+```
+
+```bash cURL
+curl -X POST "https://api.skyvern.com/v1/credentials" \
+ -H "x-api-key: $SKYVERN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "name": "Acme Portal Login",
+ "credential_type": "password",
+ "credential": {
+ "username": "[email protected]",
+ "password": "secure_password",
+ "totp": "JBSWY3DPEHPK3PXP",
+ "totp_type": "authenticator"
+ }
+ }'
+```
+</CodeGroup>
+
+### TOTP types
+
+| Type | Description |
+|------|-------------|
+| `authenticator` | Standard TOTP codes (Google Authenticator, Authy, etc.) |
+| `email` | Codes sent via email that you'll push to Skyvern |
+| `text` | Codes sent via SMS that you'll push to Skyvern |
+
+<Tip>
+Skyvern generates TOTP codes using standard 30-second windows. If the current code has less than 20 seconds remaining, Skyvern automatically uses the next code to ensure successful entry.
+</Tip>
+
+### Finding your TOTP secret
+
+Most sites show the secret when you set up 2FA:
+
+1. Go to your account's security settings
+2. Click "Set up authenticator app"
+3. Look for "Can't scan the QR code?" or "Manual entry"
+4. Copy the secret key (usually Base32 format like `JBSWY3DPEHPK3PXP`)
+
+<Note>
+If you've already set up 2FA and don't have the secret, you may need to disable and re-enable 2FA to see the secret again. Contact [[email protected]](mailto:[email protected]) for help.
+</Note>
+
+---
+
+## Method 2: Push codes to Skyvern
+
+**Best for:** Codes sent to email or SMS that you can programmatically forward.
+
+When your automation encounters a 2FA prompt, Skyvern polls for codes that you push via API. Your email or SMS forwarding system sends codes to Skyvern as they arrive.
+
+### Step 1: Set up code forwarding
+
+Configure your email or SMS to forward verification codes to Skyvern. Common approaches:
+
+- **Email:** Gmail filter + Zapier webhook
+- **SMS:** Twilio webhook to your server
+- **Email:** AWS SES + Lambda function
+
+<AccordionGroup>
+<Accordion title="How to set up Email Forwarding with Zapier?">
+
+This setup requires a Zapier Pro plan account.
+
+<Steps>
+ <Step title="Create a Zapier Zap">
+ {/* TODO: Replace with actual video */}
+ <Frame>
+ <video
+ autoPlay
+ muted
+ loop
+ playsInline
+ className="rounded-xl"
+ src="/images/zapier-forwarding-setup.mp4"
+ ></video>
+ </Frame>
+
+ 1. Go to [zapier.com](https://zapier.com/app/home) and create a new Zap
+ 2. In the newly created Zap draft, click the "Trigger" button
+ 3. Click **Email by Zapier**
+ 4. In the Email "Setup", pick **New Inbound Email** in the Trigger event selection. Click **Continue**
+ 5. In Email "Configure", create an email address which will be used to forward emails for TOTP codes. Click **Continue**
+ 6. Click the "Action" button and add **Webhooks by Zapier**
+ 7. In the Setup, choose **POST** under the Action event selection. Click **Continue**
+ 8. In the "Configure", set up these fields to make a POST request to Skyvern's TOTP API:
+ - **URL:** `https://api.skyvern.com/v1/credentials/totp`
+ - **Payload Type:** `json`
+ - **Data:**
+ - `totp_identifier`: choose **Raw To Email** after clicking the "+" sign
+ - `content`: choose **Body Plain** after clicking the "+" sign
+ - `source`: `email`
+ - **Headers:**
+ - `x-api-key`: your Skyvern API key
+ 9. Click **Continue**
+ </Step>
+ <Step title="Add forwarding email and create a filter in Gmail">
+ Go to Gmail Settings → Forwarding and POP/IMAP → click **Add a forwarding address** → enter the Zapier email address you created. Complete any verification steps.
+
+ Then go to **Filters and Blocked Addresses**. Click **Create a new filter** and set up a filtering rule for your TOTP (2FA/MFA) emails. Click **Create filter**, check **Forward it to**, pick the Zapier email address, and update the filter.
+
+ <Frame>
+ <img src="/images/totp/create_email_forwarding.png" alt="Gmail forwarding filter" width="400"/>
+ </Frame>
+ </Step>
+ <Step title="Test it end to end">
+ Forward any previous TOTP email to the Zapier email address you created.
+
+ In Zapier, under the "Test" of the Webhooks action, send a request to test it out. If successful, you should see a "A request was sent to Webhooks by Zapier" message.
+ </Step>
+</Steps>
+
+</Accordion>
+<Accordion title="How to set up SMS Forwarding with Twilio?">
+
+Use a virtual phone number service like [Twilio](https://www.twilio.com/en-us/docs/usage/tutorials/how-to-use-your-free-trial-account) or [Plivo](https://www.plivo.com/) to receive SMS codes and forward them to Skyvern.
+
+<Steps>
+ <Step title="Set up a Twilio phone number">
+ Create a Twilio account and provision a phone number. This number will receive the SMS verification codes.
+ </Step>
+ <Step title="Create a Twilio Function to forward codes">
+ In your Twilio console, create a new Function that forwards incoming SMS to Skyvern's TOTP API:
+
+ ```javascript
+ // Twilio Function
+ exports.handler = async function(context, event, callback) {
+ const axios = require('axios');
+
+ await axios.post('https://api.skyvern.com/v1/credentials/totp', {
+ totp_identifier: event.To, // Your Twilio phone number
+ content: event.Body,
+ source: 'phone'
+ }, {
+ headers: {
+ 'x-api-key': context.SKYVERN_API_KEY,
+ 'Content-Type': 'application/json'
+ }
+ });
+
+ return callback(null, new Twilio.Response());
+ };
+ ```
+
+ Add your `SKYVERN_API_KEY` as an environment variable in the Twilio Function configuration.
+ </Step>
+ <Step title="Configure the webhook">
+ In your Twilio phone number settings, set the **A Message Comes In** webhook to point to your Twilio Function URL.
+ </Step>
+ <Step title="Test it">
+ Send a test SMS to your Twilio number and verify the code appears in Skyvern:
+
+ ```bash
+ curl -X GET "https://api.skyvern.com/v1/credentials/totp?totp_identifier=YOUR_TWILIO_NUMBER" \
+ -H "x-api-key: $SKYVERN_API_KEY"
+ ```
+ </Step>
+</Steps>
+
+</Accordion>
+</AccordionGroup>
+
+### Step 2: Start the run with a TOTP identifier
+
+When running your login, include a `totp_identifier` that matches what you'll use when pushing codes:
+
+<CodeGroup>
+```python Python
+result = await client.login(
+ credential_type="skyvern",
+ url="https://portal.example.com/login",
+ credential_id="cred_xyz789",
+ totp_identifier="[email protected]", # Must match when pushing code
+)
+```
+
+```bash cURL
+curl -X POST "https://api.skyvern.com/v1/run/tasks/login" \
+ -H "x-api-key: $SKYVERN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "credential_type": "skyvern",
+ "url": "https://portal.example.com/login",
+ "credential_id": "cred_xyz789",
+ "totp_identifier": "[email protected]"
+ }'
+```
+</CodeGroup>
+
+### Step 3: Push the code when received
+
+When the verification code arrives, push it to Skyvern:
+
+<CodeGroup>
+```python Python
+await client.send_totp_code(
+ totp_identifier="[email protected]",
+ content="Your verification code is 123456", # Full email/SMS body
+ source="email",
+)
+```
+
+```typescript TypeScript
+await client.sendTotpCode({
+ totp_identifier: "[email protected]",
+ content: "Your verification code is 123456",
+ source: "email",
+});
+```
+
+```bash cURL
+curl -X POST "https://api.skyvern.com/v1/credentials/totp" \
+ -H "x-api-key: $SKYVERN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "totp_identifier": "[email protected]",
+ "content": "Your verification code is 123456",
+ "source": "email"
+ }'
+```
+</CodeGroup>
+
+<Note>
+If `content` is longer than 10 characters, Skyvern's AI extracts the verification code automatically. You can send the full email or SMS body without parsing it yourself.
+</Note>
+
+
+---
+
+## Method 3: Skyvern pulls from your endpoint
+
+**Best for:** Environments where you control the system receiving 2FA codes and can expose them via an HTTP endpoint.
+
+Instead of pushing codes to Skyvern, you implement an endpoint that Skyvern polls until a code is available.
+
+### Step 1: Implement the endpoint
+
+Your endpoint must accept POST requests and return the verification code:
+
+**Request from Skyvern:**
+```http
+POST https://your-server.com/totp-webhook
+x-skyvern-signature: <hmac-sha256-signature>
+Content-Type: application/json
+
+{
+ "task_id": "tsk_123456"
+}
+```
+
+**Expected response:**
+```json
+{
+ "task_id": "tsk_123456",
+ "verification_code": "123456"
+}
+```
+
+### Step 2: Verify request signatures
+
+Skyvern signs all requests using HMAC-SHA256 with your API key. Verify the signature to ensure requests are authentic:
+
+```python
+import hmac
+import hashlib
+
+def verify_skyvern_request(request, api_key: str) -> bool:
+ signature = request.headers.get("x-skyvern-signature")
+ payload = request.body # bytes
+
+ expected = hmac.new(
+ api_key.encode("utf-8"),
+ msg=payload,
+ digestmod=hashlib.sha256
+ ).hexdigest()
+
+ return hmac.compare_digest(signature, expected)
+```
+
+### Step 3: Configure the login
+
+Pass `totp_url` when running your login:
+
+<CodeGroup>
+```python Python
+result = await client.login(
+ credential_type="skyvern",
+ url="https://portal.example.com/login",
+ credential_id="cred_xyz789",
+ totp_url="https://your-server.com/totp-webhook",
+)
+```
+
+```bash cURL
+curl -X POST "https://api.skyvern.com/v1/run/tasks/login" \
+ -H "x-api-key: $SKYVERN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "credential_type": "skyvern",
+ "url": "https://portal.example.com/login",
+ "credential_id": "cred_xyz789",
+ "totp_url": "https://your-server.com/totp-webhook"
+ }'
+```
+</CodeGroup>
+
+Skyvern polls your endpoint every 10 seconds until a code is returned or the timeout is reached.
+
+---
+
+## Method 4: Magic links
+
+**Best for:** Passwordless authentication systems that send one-time login links.
+
+When a site uses magic links instead of passwords, push the link to Skyvern:
+
+<CodeGroup>
+```python Python
+await client.send_totp_code(
+ totp_identifier="[email protected]",
+ content="https://portal.example.com/login?token=abc123xyz",
+ source="email",
+)
+```
+
+```bash cURL
+curl -X POST "https://api.skyvern.com/v1/credentials/totp" \
+ -H "x-api-key: $SKYVERN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "totp_identifier": "[email protected]",
+ "content": "https://portal.example.com/login?token=abc123xyz",
+ "source": "email"
+ }'
+```
+</CodeGroup>
+
+<Note>
+Skyvern automatically detects URLs and classifies them as magic links. The automation will navigate to the link to complete authentication.
+</Note>
+
+For magic link flows, structure your workflow in two parts:
+
+1. **Trigger the magic link** — Navigate to login and enter email
+2. **Complete login** — Use the magic link as the starting URL for the next step
+
+---
+
+## Password manager TOTP
+
+If you store TOTP secrets in Bitwarden or 1Password, Skyvern can retrieve both the password and TOTP code in a single request.
+
+### Bitwarden
+
+Store your TOTP secret in Bitwarden's authenticator field:
+
+1. Open the vault item in Bitwarden
+2. Click "Authenticator Key (TOTP)"
+3. Enter your TOTP secret or scan the QR code
+4. Skyvern retrieves both password and TOTP when using this credential
+
+**Supported TOTP formats:**
+- Raw secret: `JBSWY3DPEHPK3PXP`
+- otpauth URI: `otpauth://totp/Example:[email protected]?secret=JBSWY3DPEHPK3PXP&issuer=Example`
+
+### 1Password
+
+Store TOTP in 1Password's one-time password field:
+
+1. Edit the login item in 1Password
+2. Add a "One-Time Password" field
+3. Enter the TOTP secret or scan the QR code
+4. Reference the item in your Skyvern workflow
+
+---
+
+## Multi-field TOTP entry
+
+Some sites split TOTP codes across multiple input fields (one digit per box). Skyvern handles this automatically:
+
+1. Detects multi-field TOTP layouts
+2. Enters the same code across all fields
+3. Caches the code to prevent requesting a new one mid-entry
+
+<Note>
+No special configuration needed. Skyvern's AI recognizes multi-field TOTP inputs and handles them correctly.
+</Note>
+
+---
+
+## Timeouts and polling
+
+Skyvern waits for 2FA codes based on configurable timeouts:
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| Polling interval | 10 seconds | How often Skyvern checks for new codes |
+| Polling timeout | 15 minutes | Maximum wait time before failing |
+
+If you're pushing codes, ensure your forwarding pipeline delivers codes within the timeout window.
+
+---
+
+## List recent codes
+
+Debug your 2FA integration by listing recent codes received:
+
+```bash
+curl -X GET "https://api.skyvern.com/v1/credentials/[email protected]&limit=10" \
+ -H "x-api-key: $SKYVERN_API_KEY"
+```
+
+**Query parameters:**
+
+| Parameter | Description |
+|-----------|-------------|
+| `totp_identifier` | Filter by identifier (email, phone, etc.) |
+| `workflow_run_id` | Filter by specific workflow run |
+| `otp_type` | Filter by type: `totp` or `magic_link` |
+| `limit` | Number of records (default 50, max 200) |
+
+<Note>
+Skyvern only returns codes from the last 10 minutes (configurable via `TOTP_LIFESPAN_MINUTES`).
+</Note>
+
+---
+
+## Next steps
+
+<CardGroup cols={2}>
+ <Card title="Store Credentials" icon="key" href="/credentials/store-credentials">
+ Set up your credential vault integration
+ </Card>
+ <Card title="Troubleshooting" icon="wrench" href="/credentials/troubleshooting-login">
+ Debug 2FA and login failures
+ </Card>
+</CardGroup>
diff --git a/docs/credentials/store-credentials.mdx b/docs/credentials/store-credentials.mdx
new file mode 100644
index 000000000..f52506171
--- /dev/null
+++ b/docs/credentials/store-credentials.mdx
@@ -0,0 +1,483 @@
+---
+title: Store Credentials
+subtitle: Securely manage login credentials, credit cards, and API secrets
+slug: credentials/store-credentials
+---
+
+Skyvern provides a credential management layer that gives you a unified API to create, use, and delete credentials. Your actual secrets are never stored in Skyvern. They live in your external vault (Bitwarden by default, or 1Password, Azure Key Vault, or your own service).
+
+---
+
+## How it works
+
+When you create a credential via Skyvern's API, two things happen:
+
+**Skyvern stores metadata** for easy lookup: credential names, IDs like `cred_xyz789`, usernames, and non-sensitive identifiers (like the last 4 digits of a card). This lets you list and manage credentials without exposing secrets.
+
+**Your vault stores the secrets**: passwords, TOTP keys, full card numbers, and API tokens. Skyvern only retrieves these at runtime when needed, then discards them immediately after use.
+
+```mermaid
+flowchart LR
+ subgraph Your Infrastructure
+ Vault[(Your Vault<br/>Bitwarden, 1Password, Azure, etc.)]
+ end
+
+ subgraph Skyvern
+ Fetch[Fetch at runtime]
+ Fill[Fill forms]
+ end
+
+ subgraph Outputs
+ Browser[Browser]
+ Logs[Logs & LLM]
+ end
+
+ Vault -->|secrets| Fetch
+ Fetch -->|real values| Fill
+ Fill -->|real values| Browser
+ Fetch -.->|"placeholders<br/>(BW_PASSWORD)"| Logs
+```
+
+This gives you:
+
+- **Friendly IDs**: Reference credentials by `cred_xyz789` instead of vault-specific item IDs
+- **Vault abstraction**: Switch between Bitwarden, Azure, or custom vaults without changing your code
+- **Security by design**: Secrets never appear in logs, API responses, or LLM prompts
+
+---
+
+## Credential types
+
+Skyvern supports three credential types, each designed for specific use cases.
+
+### Password credentials
+
+Store usernames, passwords, and optional TOTP secrets for website logins.
+
+<CodeGroup>
+```python Python
+import os
+from skyvern import Skyvern
+
+client = Skyvern(api_key=os.getenv("SKYVERN_API_KEY"))
+
+credential = await client.create_credential(
+ name="Acme Portal Login",
+ credential_type="password",
+ credential={
+ "username": "[email protected]",
+ "password": "secure_password_here",
+ },
+)
+
+print(f"Credential ID: {credential.credential_id}")
+```
+
+```typescript TypeScript
+import { SkyvernClient } from "@skyvern/client";
+
+const client = new SkyvernClient({
+ apiKey: process.env.SKYVERN_API_KEY,
+});
+
+const credential = await client.createCredential({
+ name: "Acme Portal Login",
+ credential_type: "password",
+ credential: {
+ username: "[email protected]",
+ password: "secure_password_here",
+ },
+});
+
+console.log(`Credential ID: ${credential.credential_id}`);
+```
+
+```bash cURL
+curl -X POST "https://api.skyvern.com/v1/credentials" \
+ -H "x-api-key: $SKYVERN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "name": "Acme Portal Login",
+ "credential_type": "password",
+ "credential": {
+ "username": "[email protected]",
+ "password": "secure_password_here"
+ }
+ }'
+```
+</CodeGroup>
+
+### Credit card credentials
+
+Store payment information for checkout automations. Skyvern only stores the last 4 digits in metadata for identification.
+
+<CodeGroup>
+```python Python
+credential = await client.create_credential(
+ name="Corporate Card",
+ credential_type="credit_card",
+ credential={
+ "card_number": "4242424242424242",
+ "card_cvv": "123",
+ "card_exp_month": "12",
+ "card_exp_year": "2028",
+ "card_brand": "visa",
+ "card_holder_name": "John Smith",
+ },
+)
+```
+
+```typescript TypeScript
+const credential = await client.createCredential({
+ name: "Corporate Card",
+ credential_type: "credit_card",
+ credential: {
+ card_number: "4242424242424242",
+ card_cvv: "123",
+ card_exp_month: "12",
+ card_exp_year: "2028",
+ card_brand: "visa",
+ card_holder_name: "John Smith",
+ },
+});
+```
+
+```bash cURL
+curl -X POST "https://api.skyvern.com/v1/credentials" \
+ -H "x-api-key: $SKYVERN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "name": "Corporate Card",
+ "credential_type": "credit_card",
+ "credential": {
+ "card_number": "4242424242424242",
+ "card_cvv": "123",
+ "card_exp_month": "12",
+ "card_exp_year": "2028",
+ "card_brand": "visa",
+ "card_holder_name": "John Smith"
+ }
+ }'
+```
+</CodeGroup>
+
+**Supported card brands:** `visa`, `mastercard`, `amex`, `discover`
+
+### Secret credentials
+
+Store API keys, tokens, or other sensitive strings for use in HTTP Request blocks or custom integrations.
+
+<CodeGroup>
+```python Python
+credential = await client.create_credential(
+ name="API Key",
+ credential_type="secret",
+ credential={
+ "secret_value": "sk-abc123xyz",
+ "secret_label": "Production API Key", # optional
+ },
+)
+```
+
+```typescript TypeScript
+const credential = await client.createCredential({
+ name: "API Key",
+ credential_type: "secret",
+ credential: {
+ secret_value: "sk-abc123xyz",
+ secret_label: "Production API Key",
+ },
+});
+```
+
+```bash cURL
+curl -X POST "https://api.skyvern.com/v1/credentials" \
+ -H "x-api-key: $SKYVERN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "name": "API Key",
+ "credential_type": "secret",
+ "credential": {
+ "secret_value": "sk-abc123xyz",
+ "secret_label": "Production API Key"
+ }
+ }'
+```
+</CodeGroup>
+
+---
+
+## Vault integrations
+
+Skyvern integrates with external password managers so credentials never leave your infrastructure.
+
+### Bitwarden
+
+Connect Skyvern to your Bitwarden organization to use existing vault items.
+
+**Cloud setup:**
+
+1. Create a Bitwarden organization at [bitwarden.com](https://bitwarden.com)
+2. Create a collection to share with Skyvern
+3. Contact [[email protected]](mailto:[email protected]) to complete the integration
+4. Get your collection ID from the Bitwarden URL
+5. Reference credentials by collection ID in your workflows
+
+**Self-hosted setup:**
+
+For self-hosted Bitwarden or Vaultwarden, configure these environment variables:
+
+```bash
+SKYVERN_AUTH_BITWARDEN_ORGANIZATION_ID=your-org-id
+SKYVERN_AUTH_BITWARDEN_MASTER_PASSWORD=your-master-password
+SKYVERN_AUTH_BITWARDEN_CLIENT_ID=user.your-client-id
+SKYVERN_AUTH_BITWARDEN_CLIENT_SECRET=your-client-secret
+BW_HOST=https://your-bitwarden-server.com
+```
+
+### 1Password
+
+Connect via service account tokens for secure credential access.
+
+1. Create a 1Password service account with access to your vault
+2. Store the service account token in Skyvern:
+
+```bash
+curl -X POST "https://api.skyvern.com/v1/credentials/onepassword/create" \
+ -H "x-api-key: $SKYVERN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "token": "your-1password-service-account-token"
+ }'
+```
+
+3. Reference vault items by ID in your workflows
+
+### Azure Key Vault
+
+Store credentials in Azure Key Vault for enterprise environments.
+
+```bash
+curl -X POST "https://api.skyvern.com/v1/credentials/azure_credential/create" \
+ -H "x-api-key: $SKYVERN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "credential": {
+ "client_id": "your-azure-client-id",
+ "client_secret": "your-azure-client-secret",
+ "tenant_id": "your-azure-tenant-id"
+ }
+ }'
+```
+
+### Custom HTTP vault
+
+Integrate your own credential service via HTTP API. Your service must implement these endpoints:
+
+| Endpoint | Method | Description |
+|----------|--------|-------------|
+| `{base_url}` | POST | Create credential, return `{"id": "..."}` |
+| `{base_url}/{id}` | GET | Return credential data |
+| `{base_url}/{id}` | DELETE | Delete credential |
+
+Configure via environment variables:
+
+```bash
+CREDENTIAL_VAULT_TYPE=custom
+CUSTOM_CREDENTIAL_API_BASE_URL=https://credentials.company.com/api/v1/credentials
+CUSTOM_CREDENTIAL_API_TOKEN=your_api_token
+```
+
+Or via API for per-organization configuration:
+
+```bash
+curl -X POST "https://api.skyvern.com/v1/credentials/custom_credential/create" \
+ -H "x-api-key: $SKYVERN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "config": {
+ "api_base_url": "https://credentials.company.com/api/v1/credentials",
+ "api_token": "your_api_token"
+ }
+ }'
+```
+
+---
+
+## Using credentials in workflows
+
+Workflows are the recommended way to use credentials. Add a credential parameter to your workflow, then reference it in login blocks.
+
+<CodeGroup>
+```python Python
+# Run a workflow with credential parameter
+result = await client.run_workflow(
+ workflow_id="wpid_abc123",
+ parameters={
+ "login_credential": "cred_xyz789", # Your credential ID
+ "target_url": "https://portal.example.com",
+ },
+)
+```
+
+```typescript TypeScript
+const result = await client.runWorkflow({
+ body: {
+ workflow_id: "wpid_abc123",
+ parameters: {
+ login_credential: "cred_xyz789",
+ target_url: "https://portal.example.com",
+ },
+ },
+});
+```
+
+```bash cURL
+curl -X POST "https://api.skyvern.com/v1/run/workflows" \
+ -H "x-api-key: $SKYVERN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "workflow_id": "wpid_abc123",
+ "parameters": {
+ "login_credential": "cred_xyz789",
+ "target_url": "https://portal.example.com"
+ }
+ }'
+```
+</CodeGroup>
+
+<Note>
+You can also manage credentials directly from the Skyvern UI. See the [Managing Credentials](/cloud/managing-credentials/overview) guide for details.
+</Note>
+
+---
+
+## Using credentials with login
+
+For direct login automations, use the dedicated `login` method which handles credential retrieval and authentication:
+
+<CodeGroup>
+```python Python
+result = await client.login(
+ credential_type="skyvern",
+ url="https://portal.example.com/login",
+ credential_id="cred_xyz789",
+ prompt="Navigate to the dashboard after logging in",
+)
+```
+
+```typescript TypeScript
+const result = await client.login({
+ credential_type: "skyvern",
+ url: "https://portal.example.com/login",
+ credential_id: "cred_xyz789",
+ prompt: "Navigate to the dashboard after logging in",
+});
+```
+
+```bash cURL
+curl -X POST "https://api.skyvern.com/v1/run/tasks/login" \
+ -H "x-api-key: $SKYVERN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "credential_type": "skyvern",
+ "url": "https://portal.example.com/login",
+ "credential_id": "cred_xyz789",
+ "prompt": "Navigate to the dashboard after logging in"
+ }'
+```
+</CodeGroup>
+
+**Credential types for login:**
+
+| Type | Description |
+|------|-------------|
+| `skyvern` | Use credentials created via Skyvern's API (stored in your configured vault) |
+| `bitwarden` | Directly reference Bitwarden vault items by collection/item ID |
+| `1password` | Directly reference 1Password vault items by vault/item ID |
+| `azure_vault` | Directly reference Azure Key Vault secrets by name |
+
+---
+
+## Managing credentials
+
+### List credentials
+
+<CodeGroup>
+```python Python
+credentials = await client.get_credentials()
+
+for cred in credentials:
+ print(f"{cred.name}: {cred.credential_id}")
+```
+
+```bash cURL
+curl -X GET "https://api.skyvern.com/v1/credentials" \
+ -H "x-api-key: $SKYVERN_API_KEY"
+```
+</CodeGroup>
+
+### Get credential metadata
+
+<CodeGroup>
+```python Python
+credential = await client.get_credential("cred_xyz789")
+print(f"Name: {credential.name}")
+print(f"Type: {credential.credential_type}")
+```
+
+```bash cURL
+curl -X GET "https://api.skyvern.com/v1/credentials/cred_xyz789" \
+ -H "x-api-key: $SKYVERN_API_KEY"
+```
+</CodeGroup>
+
+<Note>
+The GET endpoint returns metadata only, never the actual credential values. This is by design for security.
+</Note>
+
+### Delete a credential
+
+<CodeGroup>
+```python Python
+await client.delete_credential("cred_xyz789")
+```
+
+```bash cURL
+curl -X POST "https://api.skyvern.com/v1/credentials/cred_xyz789/delete" \
+ -H "x-api-key: $SKYVERN_API_KEY"
+```
+</CodeGroup>
+
+<Warning>
+Credential deletion is permanent. Workflows using the deleted credential will fail on their next run.
+</Warning>
+
+---
+
+## Security architecture
+
+Skyvern's credential handling is designed with security at every layer:
+
+1. **Vault fetch**: Credentials are retrieved from your external vault only when needed
+2. **Memory only**: Values exist in Skyvern's memory briefly during execution
+3. **Placeholder tokens**: When sending data to LLMs, real values are replaced with tokens like `BW_PASSWORD`
+4. **No persistence**: Real values are never written to databases, logs, or API responses
+5. **LLM isolation**: Credentials are never sent to language models. The LLM sees only placeholder tokens
+
+<Note>
+When you view a run's artifacts or recordings, you'll see placeholder values like `BW_PASSWORD`, `BW_USERNAME`, or `BW_TOTP` instead of actual credentials.
+</Note>
+
+---
+
+## Next steps
+
+<CardGroup cols={2}>
+ <Card title="Handle 2FA" icon="shield" href="/credentials/handle-2fa">
+ Set up two-factor authentication for your automations
+ </Card>
+ <Card title="Troubleshooting" icon="wrench" href="/credentials/troubleshooting-login">
+ Debug common login failures
+ </Card>
+</CardGroup>
diff --git a/docs/credentials/troubleshooting-login.mdx b/docs/credentials/troubleshooting-login.mdx
new file mode 100644
index 000000000..f6c30fde6
--- /dev/null
+++ b/docs/credentials/troubleshooting-login.mdx
@@ -0,0 +1,337 @@
+---
+title: Troubleshooting Login Failures
+subtitle: Debug common authentication issues in your automations
+slug: credentials/troubleshooting-login
+---
+
+Login failures are the most common issue in web automation. This guide covers the most frequent problems and how to resolve them.
+
+---
+
+## Common failure patterns
+
+### Credentials not entered
+
+**Symptoms:** Task completes but login never happened. The final screenshot shows the login page.
+
+**Causes:**
+- Credential parameter not linked to workflow
+- Wrong `credential_id` referenced
+- Vault connection failed
+
+**Solutions:**
+
+1. Verify the credential exists:
+
+```bash
+curl -X GET "https://api.skyvern.com/v1/credentials/cred_xyz789" \
+ -H "x-api-key: $SKYVERN_API_KEY"
+```
+
+2. Check workflow parameter configuration—ensure the credential parameter is linked to a Login block
+
+3. For vault integrations (Bitwarden, 1Password), verify connectivity:
+ - Check vault credentials are valid
+ - Ensure collection/vault IDs are correct
+ - Test vault access independently
+
+---
+
+### Wrong credentials entered
+
+**Symptoms:** Site shows "Invalid username or password" error.
+
+**Causes:**
+- Credentials stored incorrectly in your vault
+- Site expects different format (email vs username)
+- Password contains special characters causing issues
+
+**Solutions:**
+
+1. **Verify credentials work manually** — Log in to the site yourself with the same credentials
+
+2. **Check username format** — Some sites require email, others want a username:
+ ```
+ ❌ john.smith
+ ```
+
+3. **Test credential retrieval** — Create a simple test task to verify Skyvern can access the credential
+
+4. **Check for copy/paste errors** — Re-enter credentials in your vault, avoiding trailing spaces
+
+---
+
+### 2FA code expired
+
+**Symptoms:** "Invalid code" or "Code expired" error after entering TOTP.
+
+**Causes:**
+- Clock drift between Skyvern and your authenticator
+- Code fetched too early in the 30-second window
+- Multi-field entry took too long
+
+**Solutions:**
+
+1. **Skyvern handles timing automatically** — If a TOTP code has less than 20 seconds remaining, Skyvern uses the next code
+
+2. **For pushed codes** — Ensure your forwarding pipeline sends codes promptly. Delays over 30 seconds cause expiration.
+
+3. **Check system clocks** — If self-hosting, ensure your server time is synchronized (NTP)
+
+4. **Retry the run** — Intermittent timing issues often resolve on retry
+
+---
+
+### 2FA code never received
+
+**Symptoms:** Task times out waiting for verification code.
+
+**Causes:**
+- Push endpoint not forwarding codes
+- `totp_url` returning errors
+- `totp_identifier` mismatch between run and push
+
+**Solutions:**
+
+1. **Verify your push endpoint** — Check that it's receiving and forwarding codes:
+
+```bash
+# Test your Zapier/webhook endpoint manually
+curl -X POST "https://api.skyvern.com/v1/credentials/totp" \
+ -H "x-api-key: $SKYVERN_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "totp_identifier": "[email protected]",
+ "content": "Your code is 123456",
+ "source": "email"
+ }'
+```
+
+2. **Check `totp_identifier` matches** — The identifier in your login must exactly match what you push:
+
+```python
+# These must match exactly
+result = await client.login(
+ credential_type="skyvern",
+ credential_id="cred_xyz789",
+ totp_identifier="[email protected]", # ← This
+ ...
+)
+
+await client.send_totp_code(
+ totp_identifier="[email protected]", # ← Must match this
+ ...
+)
+```
+
+3. **List recent codes** to verify they're being received:
+
+```bash
+curl -X GET "https://api.skyvern.com/v1/credentials/[email protected]" \
+ -H "x-api-key: $SKYVERN_API_KEY"
+```
+
+4. **For pull-based 2FA** — Check your endpoint returns the correct format:
+
+```json
+{
+ "task_id": "tsk_123456",
+ "verification_code": "123456"
+}
+```
+
+---
+
+## Site-specific issues
+
+### CAPTCHA blocking login
+
+**Symptoms:** Login page shows CAPTCHA challenge that blocks automation.
+
+**Solutions:**
+
+1. **Use residential proxies** — Many CAPTCHAs trigger on datacenter IPs:
+
+```python
+result = await client.run_task(
+ url="https://portal.example.com/login",
+ prompt="Log in to the portal",
+ proxy_location="RESIDENTIAL",
+)
+```
+
+2. **Some CAPTCHAs can be solved** — Skyvern's AI can solve simple image-based challenges
+
+3. **Browser profiles help** — Persistent browser state reduces CAPTCHA frequency:
+
+```python
+result = await client.login(
+ credential_type="skyvern",
+ url="https://portal.example.com/login",
+ credential_id="cred_xyz789",
+ browser_profile_id="bp_abc123",
+)
+```
+
+4. **For persistent CAPTCHAs** — Contact [[email protected]](mailto:[email protected]) for enterprise CAPTCHA solutions
+
+---
+
+### SSO/OAuth redirects
+
+**Symptoms:** Task fails when encountering "Sign in with Google/Microsoft" or similar SSO flows.
+
+**Solutions:**
+
+1. **Prefer direct credentials** — SSO flows involve multiple domains and are harder to automate. If possible, use direct username/password login.
+
+2. **For required SSO** — Use browser sessions to maintain authentication state:
+
+```python
+# First run: Complete SSO manually or with Skyvern
+result = await client.run_task(
+ url="https://portal.example.com/login",
+ prompt="Log in using Google SSO",
+ browser_session_id="bs_xyz789", # Persistent session
+)
+
+# Subsequent runs: Reuse the authenticated session
+result = await client.run_task(
+ url="https://portal.example.com/dashboard",
+ prompt="Navigate to reports",
+ browser_session_id="bs_xyz789",
+)
+```
+
+3. **Check for direct login options** — Many sites offer traditional login alongside SSO (often under "Other login options")
+
+---
+
+### Multi-step login flows
+
+**Symptoms:** Task enters username but fails to proceed to password page, or misses subsequent steps.
+
+**Solutions:**
+
+1. **Increase `max_steps`** — Multi-step logins require more navigation:
+
+```python
+result = await client.run_task(
+ url="https://portal.example.com/login",
+ prompt="Log in with my credentials",
+ max_steps=15, # Default is 10
+)
+```
+
+2. **Use explicit prompts** — Guide Skyvern through the steps:
+
+```python
+result = await client.run_task(
+ url="https://portal.example.com/login",
+ prompt="""
+ 1. Enter the username and click Next
+ 2. Wait for the password page to load
+ 3. Enter the password and click Sign In
+ 4. If 2FA is required, enter the code
+ """,
+)
+```
+
+<Tip>
+For login flows with credentials, use the `login()` method—it handles credential retrieval and 2FA automatically. Use `run_task()` only for general automation without credential management.
+</Tip>
+
+3. **Review recordings** — Watch the recording artifact to see exactly where the flow breaks
+
+---
+
+## Debugging checklist
+
+Use this checklist to systematically debug login failures:
+
+<Accordion title="Step-by-step debugging process">
+
+**1. Check run status**
+
+```bash
+curl -X GET "https://api.skyvern.com/v1/runs/YOUR_RUN_ID" \
+ -H "x-api-key: $SKYVERN_API_KEY"
+```
+
+Look at `status` and `failure_reason`.
+
+**2. Review the recording**
+
+Download the recording artifact and watch where the automation fails:
+
+```bash
+curl -X GET "https://api.skyvern.com/v1/runs/YOUR_RUN_ID/artifacts?artifact_type=recording" \
+ -H "x-api-key: $SKYVERN_API_KEY"
+```
+
+**3. Check the final screenshot**
+
+```bash
+curl -X GET "https://api.skyvern.com/v1/runs/YOUR_RUN_ID/artifacts?artifact_type=screenshot_final" \
+ -H "x-api-key: $SKYVERN_API_KEY"
+```
+
+**4. Verify credential access**
+
+```bash
+curl -X GET "https://api.skyvern.com/v1/credentials/YOUR_CREDENTIAL_ID" \
+ -H "x-api-key: $SKYVERN_API_KEY"
+```
+
+**5. For 2FA issues, check code history**
+
+```bash
+curl -X GET "https://api.skyvern.com/v1/credentials/totp?totp_identifier=YOUR_IDENTIFIER" \
+ -H "x-api-key: $SKYVERN_API_KEY"
+```
+
+**6. Review LLM reasoning**
+
+Check `llm_request` and `llm_response` artifacts to understand what the AI was thinking.
+
+</Accordion>
+
+---
+
+## Error messages reference
+
+| Error | Meaning | Fix |
+|-------|---------|-----|
+| `FailedToGetTOTPVerificationCode` | HTTP request to `totp_url` failed | Check endpoint availability and response format |
+| `NoTOTPVerificationCodeFound` | Polling timed out without receiving code | Ensure codes are pushed or endpoint returns codes |
+| `TOTPExpiredError` | Code became invalid during entry | Usually auto-resolved on retry; check timing pipeline |
+| `CredentialParameterNotFoundError` | Referenced credential parameter not found | Verify credential ID and parameter configuration |
+| `CredentialParameterParsingError` | Failed to parse credential data | Check credential format matches expected schema |
+| `CustomCredentialConfigurationError` | Custom vault service misconfigured | Verify API base URL and token are set correctly |
+
+---
+
+## Getting help
+
+If you're stuck after trying the above solutions, contact Skyvern support with:
+
+1. **Run ID** — The `run_id` from your failed run
+2. **Recording** — Download and attach the recording artifact
+3. **Description** — What you expected vs. what happened
+4. **Target site** — The URL you're trying to automate (if not confidential)
+
+Contact [[email protected]](mailto:[email protected]) or join our [Discord](https://discord.gg/skyvern) for community help.
+
+---
+
+## Next steps
+
+<CardGroup cols={2}>
+ <Card title="Store Credentials" icon="key" href="/credentials/store-credentials">
+ Review credential setup
+ </Card>
+ <Card title="Handle 2FA" icon="shield" href="/credentials/handle-2fa">
+ Configure two-factor authentication
+ </Card>
+</CardGroup>
diff --git a/docs/docs.json b/docs/docs.json
index 8a9fe2353..cf1fd8e1b 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -39,7 +39,16 @@
"tabs": [
{
"tab": "Home",
- "pages": ["index"]
+ "pages": [
+ "index",
+ "nav/getting-started",
+ "nav/cloud-ui",
+ "nav/developers",
+ "nav/cookbooks",
+ "nav/changelog",
+ "nav/api-reference",
+ "nav/sdk-reference"
+ ]
},
{
"tab": "Getting Started",
@@ -134,6 +143,14 @@
"running-automations/extract-structured-data"
]
},
+ {
+ "group": "Handling Authentication",
+ "pages": [
+ "credentials/store-credentials",
+ "credentials/handle-2fa",
+ "credentials/troubleshooting-login"
+ ]
+ },
{
"group": "Multi-Step Automations",
"pages": [
diff --git a/docs/getting-started/ai-agents-quickstart.mdx b/docs/getting-started/ai-agents-quickstart.mdx
index 6070c1d7f..deba58df2 100644
--- a/docs/getting-started/ai-agents-quickstart.mdx
+++ b/docs/getting-started/ai-agents-quickstart.mdx
@@ -4,22 +4,222 @@ subtitle: Give your AI coding assistant full browser automation in one command
slug: getting-started/ai-agents-quickstart
---
-Skyvern's MCP server and Skills let AI assistants (Claude Code, Cursor, Windsurf, Codex) control browsers, extract data, and run workflows through natural language. This page gets you set up.
+export const ApiKeyPrompt = ({ children }) => {
+ const [apiKey, setApiKey] = useState("");
+ const [copied, setCopied] = useState(false);
+ const text = typeof children === "string" ? children : String(children);
+ const lines = text.split("\n");
+ const indents = lines.slice(1).filter(l => l.trim()).map(l => l.match(/^(\s*)/)[1].length);
+ const min = indents.length ? Math.min(...indents) : 0;
+ const raw = min > 0 ? lines.map((l, i) => i === 0 ? l : l.slice(min)).join("\n") : text;
+ const content = apiKey ? raw.replace(/PASTE_YOUR_API_KEY_HERE/g, apiKey) : raw;
+ return (
+ <div>
+ <input
+ type="text"
+ placeholder="Paste your Skyvern API key"
+ value={apiKey}
+ onChange={(e) => setApiKey(e.target.value)}
+ spellCheck={false}
+ autoComplete="off"
+ style={{
+ width: "100%",
+ padding: "10px 14px",
+ marginBottom: "12px",
+ borderRadius: "8px",
+ border: "1px solid var(--border, #d1d5db)",
+ fontSize: "14px",
+ fontFamily: "ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace",
+ backgroundColor: "var(--background, transparent)",
+ color: "inherit",
+ outline: "none",
+ boxSizing: "border-box",
+ }}
+ />
+ <div style={{ position: "relative", borderRadius: "8px", overflow: "hidden" }}>
+ <button
+ onClick={async () => {
+ await navigator.clipboard.writeText(content);
+ setCopied(true);
+ setTimeout(() => setCopied(false), 2000);
+ }}
+ style={{
+ position: "absolute",
+ top: "10px",
+ right: "10px",
+ padding: "4px 12px",
+ fontSize: "12px",
+ borderRadius: "6px",
+ border: "none",
+ backgroundColor: "rgba(255, 255, 255, 0.1)",
+ color: "#a1a1aa",
+ cursor: "pointer",
+ zIndex: 1,
+ }}
+ >
+ {copied ? "Copied!" : "Copy"}
+ </button>
+ <pre style={{
+ margin: 0,
+ padding: "16px",
+ overflowX: "auto",
+ fontSize: "13px",
+ lineHeight: "1.7",
+ backgroundColor: "#0d1117",
+ color: "#e6edf3",
+ }}>
+ <code>{content}</code>
+ </pre>
+ </div>
+ </div>
+ );
+};
+
+Skyvern lets AI coding assistants (Claude Code, Cursor, Windsurf, Codex) control browsers, extract data, and run workflows.
+
+**Copy the prompt below** into your AI coding agent and you'll have a running automation in minutes.
+
+<Note>
+Looking to self-host instead? See the [local installation guide](/getting-started/quickstart) for full setup instructions.
+</Note>
+
+## 1. Get your API key
+
+Go to [app.skyvern.com/settings](https://app.skyvern.com/settings) and get your API key.
+
+<Frame>
+ <img src="/images/get-api-key.png" alt="Skyvern Settings page showing the API Keys section with a masked key and reveal/copy buttons" width="500" />
+</Frame>
+
+## 2. Give this prompt to your AI coding agent
+
+Paste your API key below, then copy the prompt into your AI coding assistant.
+
+It will:
+1. install the Skyvern Python/Typescript SDK
+2. Ask what you want to automate (say "Go to Hacker News and get the top comment of the #1 post" for example)
+3. Write the code to a file, and run it.
-## Choose your path
+<Tabs>
+<Tab title="Python">
-<CardGroup cols={2}>
- <Card title="Cloud (30 seconds)" icon="cloud">
- Already have a Skyvern Cloud account? Jump to the [MCP config](#cloud-setup) for your client below.
- </Card>
- <Card title="Local (2 minutes)" icon="terminal">
- Want to self-host? Run `skyvern quickstart` and it handles everything. See [local setup](#local-setup).
- </Card>
-</CardGroup>
+<ApiKeyPrompt>{`Set up Skyvern for browser automation:
+
+1. Install the Skyvern Python SDK (requires Python 3.11, 3.12, or 3.13).
+ If you hit version errors, use pipx to install in an isolated environment:
+ pip install skyvern
+ # or: pipx install skyvern
+
+2. Install all Skyvern skills into this project:
+ skyvern skill copy --output .claude/skills/
+
+3. Set my API key:
+ export SKYVERN_API_KEY="PASTE_YOUR_API_KEY_HERE"
+
+Now ask me what I want to automate in the browser. Suggest this as a default:
+"Go to Hacker News and get the top comment of the #1 post"
+
+After I respond, create a skyvern-tasks/ folder and save a Python file there
+using this template — replace <TASK> and <URL> with what I asked for:
+
+ import os
+ import asyncio
+ from skyvern import Skyvern
+
+ async def main():
+ client = Skyvern(api_key=os.getenv("SKYVERN_API_KEY"))
+
+ result = await client.run_task(
+ prompt="<TASK>",
+ url="<URL>",
+ )
+
+ print(f"Task started: {result.run_id}")
+ print(f"View live: {result.app_url}")
+
+ while True:
+ run = await client.get_run(result.run_id)
+ print(f"Status: {run.status}")
+
+ if run.status in ("completed", "failed", "terminated", "timed_out", "canceled"):
+ break
+
+ await asyncio.sleep(5)
+
+ print(f"Final status: {run.status}")
+ print(f"Output: {run.output}")
+ if run.recording_url:
+ print(f"Recording: {run.recording_url}")
+
+ asyncio.run(main())
+
+Run the file and show me the output.`}</ApiKeyPrompt>
+
+</Tab>
+<Tab title="TypeScript">
+
+<ApiKeyPrompt>{`Set up Skyvern for browser automation:
+
+1. Initialize a Node.js project (if needed) and install the Skyvern TypeScript SDK:
+ npm init -y
+ npm install @skyvern/client
+
+2. Set my API key:
+ export SKYVERN_API_KEY="PASTE_YOUR_API_KEY_HERE"
-## Cloud setup
+Now ask me what I want to automate in the browser. Suggest this as a default:
+"Go to Hacker News and get the top comment of the #1 post"
-Get your API key from [Settings](https://app.skyvern.com/settings) in the Skyvern dashboard, then pick your client.
+After I respond, create a skyvern-tasks/ folder and save a TypeScript file there
+using this template — replace <TASK> and <URL> with what I asked for:
+
+ import { SkyvernClient } from "@skyvern/client";
+
+ async function main() {
+ const client = new SkyvernClient({
+ apiKey: process.env.SKYVERN_API_KEY,
+ });
+
+ const result = await client.runTask({
+ body: {
+ prompt: "<TASK>",
+ url: "<URL>",
+ },
+ });
+
+ console.log(\`Task started: \${result.run_id}\`);
+ console.log(\`View live: \${result.app_url}\`);
+
+ const terminalStatuses = ["completed", "failed", "terminated", "timed_out", "canceled"];
+ let run;
+ while (true) {
+ run = await client.getRun(result.run_id);
+ console.log(\`Status: \${run.status}\`);
+
+ if (terminalStatuses.includes(run.status)) break;
+
+ await new Promise((resolve) => setTimeout(resolve, 5000));
+ }
+
+ console.log(\`Final status: \${run.status}\`);
+ console.log(\`Output: \${JSON.stringify(run.output, null, 2)}\`);
+ if (run.recording_url) {
+ console.log(\`Recording: \${run.recording_url}\`);
+ }
+ }
+
+ main();
+
+Run the file and show me the output.`}</ApiKeyPrompt>
+
+</Tab>
+</Tabs>
+
+## 3. Next steps
+
+### Connect the MCP server
+
+Give your AI coding assistant direct browser control through natural language — no SDK code needed.
<Tabs>
<Tab title="Claude Code">
@@ -66,33 +266,6 @@ Add to `~/.codeium/windsurf/mcp_config.json`:
}
```
-</Tab>
-<Tab title="Claude Desktop">
-
-Add to your Claude Desktop config file:
-
-- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
-- **Linux**: `~/.config/Claude/claude_desktop_config.json`
-- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
-
-```json
-{
- "mcpServers": {
- "Skyvern": {
- "command": "npx",
- "args": [
- "mcp-remote",
- "https://api.skyvern.com/mcp/",
- "--header",
- "x-api-key:YOUR_SKYVERN_API_KEY"
- ]
- }
- }
-}
-```
-
-Requires Node.js >= 20 for [mcp-remote](https://www.npmjs.com/package/mcp-remote).
-
</Tab>
<Tab title="Codex">
@@ -109,85 +282,30 @@ x-api-key = "YOUR_SKYVERN_API_KEY"
</Tab>
</Tabs>
-That's it. Ask your assistant to open a browser and navigate to any site.
-
-<Tip>
-Verify it works — paste this into your AI assistant: "Use Skyvern to create a browser session, go to news.ycombinator.com, and extract the title of the top post."
-</Tip>
-
-## Local setup
-
-`skyvern quickstart` is the one-command path for self-hosting. Run it from your project or repo root:
-
-```bash
-pip install skyvern
-skyvern quickstart
-```
-
-The interactive wizard will:
-- Set up a PostgreSQL database (detects local install or uses Docker)
-- Configure your LLM provider (OpenAI, Anthropic, Gemini, Ollama, etc.)
-- Write MCP config for your AI client (Claude Code, Cursor, Windsurf)
-- Install bundled Skills into `.claude/skills/` (Claude Code only)
-
-If you only want to configure without starting services, use `skyvern init` instead, then start the server manually:
-
-```bash
-skyvern run server
-```
-
-For the full local setup guide including browser modes and environment configuration, see [Run with a local browser](/getting-started/quickstart#run-with-a-local-browser).
-
-## What gets installed
-
-### MCP Server
-
-33 tools across 6 categories that your AI assistant calls automatically:
-
-| Category | What it does |
-|----------|-------------|
-| **Browser sessions** | Open, manage, and reuse browser instances |
-| **Browser actions** | Navigate, click, type, scroll — via natural language or selectors |
-| **Data extraction** | Pull structured data from pages, take screenshots, run JavaScript |
-| **Validation** | AI-powered checks on page state (returns true/false) |
-| **Credentials** | Look up stored credentials for login flows |
-| **Workflows** | Build and execute multi-step automations |
-
-Full reference: [MCP Server](/integrations/mcp)
-
-### Skills
-
-Markdown files that teach your AI assistant Skyvern patterns. Skills are **not** MCP tools — they're documentation your agent reads for context on how to use the CLI and API effectively.
-
-```bash
-skyvern skill list # List available skills
-skyvern skill show skyvern # Render a skill in the terminal
-```
-
-Full reference: [CLI & Skills](/integrations/cli#skills)
-
-## Try it
-
-Paste any of these into your AI assistant:
-
-| Prompt | What happens |
-|--------|-------------|
-| "Use Skyvern to go to news.ycombinator.com and extract the top 5 post titles as JSON" | Creates a session, navigates, extracts structured data, closes |
-| "Create a Skyvern browser session and take a screenshot of example.com" | Session creation + screenshot capture |
-| "Run a Skyvern workflow that navigates to [url] and fills out the contact form with name 'Jane Doe' and email '[email protected]'" | Multi-step workflow with form filling |
-| "List my Skyvern credentials and use one to log into [site]" | Credential lookup + authenticated login |
-
-## Tips for better results
-
-- Tell your agent to **use Skyvern MCP** explicitly when you want browser automation
-- Be specific: "extract the price from the product page" beats "get info from the site"
-- For multi-step flows, ask your agent to use **workflows** or **browser sessions** with persistent state
-- Don't hardcode passwords — use `skyvern credential` to store them securely
-- Use `--json` output when composing CLI commands in scripts
-
-## Next steps
+### Keep building
<CardGroup cols={3}>
+ <Card
+ title="Build a Workflow"
+ icon="diagram-project"
+ href="/multi-step-automations/build-a-workflow"
+ >
+ Chain multiple steps into a single automation with loops, conditionals, and data passing
+ </Card>
+ <Card
+ title="Extract Structured Data"
+ icon="database"
+ href="/running-automations/extract-structured-data"
+ >
+ Define a JSON schema to get typed output from your automations
+ </Card>
+ <Card
+ title="Handle Logins"
+ icon="key"
+ href="/sdk-reference/credentials"
+ >
+ Store credentials securely for sites that require authentication
+ </Card>
<Card
title="Full MCP Reference"
icon="server"
@@ -200,13 +318,13 @@ Paste any of these into your AI assistant:
icon="terminal"
href="/integrations/cli"
>
- Browser commands, workflow management, and skill system
+ Browser commands, workflow management, and the skill system
</Card>
<Card
- title="API Quickstart"
- icon="code"
- href="/getting-started/quickstart"
+ title="Use Webhooks"
+ icon="webhook"
+ href="/going-to-production/webhooks"
>
- Use the Python or TypeScript SDK directly
+ Get notified when tasks complete instead of polling
</Card>
</CardGroup>
diff --git a/docs/images/skyvern-explainer.png b/docs/images/skyvern-explainer.png
new file mode 100644
index 000000000..217136e3d
Binary files /dev/null and b/docs/images/skyvern-explainer.png differ
diff --git a/docs/images/zapier-forwarding-setup.mp4 b/docs/images/zapier-forwarding-setup.mp4
new file mode 100644
index 000000000..5de110a11
Binary files /dev/null and b/docs/images/zapier-forwarding-setup.mp4 differ
diff --git a/docs/index.mdx b/docs/index.mdx
index 17723e948..f1b2696d3 100644
--- a/docs/index.mdx
+++ b/docs/index.mdx
@@ -112,27 +112,74 @@ mode: custom
<div className="sk-bento-row sk-bento-4col">
<a href="/docs/cookbooks/bulk-invoice-downloader" className="sk-bento-cell sk-bento-cell-link sk-bento-cell-sm sk-usecase-teal">
+ <span className="sk-usecase-icon">
+ <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/><line x1="12" y1="18" x2="12" y2="12"/><polyline points="9 15 12 18 15 15"/></svg>
+ </span>
<h4 className="sk-cell-title-sm">Download invoices</h4>
<p className="sk-cell-desc-sm">Log into vendor portals, find invoices, download PDFs.</p>
<span className="sk-mono sk-arrow-sm">↗</span>
</a>
<a href="/docs/cookbooks/job-application-filler" className="sk-bento-cell sk-bento-cell-link sk-bento-cell-sm sk-usecase-orange">
+ <span className="sk-usecase-icon">
+ <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round"><path d="M11 4H4a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7"/><path d="M18.5 2.5a2.121 2.121 0 0 1 3 3L12 15l-4 1 1-4 9.5-9.5z"/></svg>
+ </span>
<h4 className="sk-cell-title-sm">Fill forms at scale</h4>
<p className="sk-cell-desc-sm">Submit applications, registrations, and compliance forms.</p>
<span className="sk-mono sk-arrow-sm">↗</span>
</a>
<a href="/docs/running-automations/extract-structured-data" className="sk-bento-cell sk-bento-cell-link sk-bento-cell-sm sk-usecase-teal">
+ <span className="sk-usecase-icon">
+ <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round"><ellipse cx="12" cy="5" rx="9" ry="3"/><path d="M21 12c0 1.66-4 3-9 3s-9-1.34-9-3"/><path d="M3 5v14c0 1.66 4 3 9 3s9-1.34 9-3V5"/></svg>
+ </span>
<h4 className="sk-cell-title-sm">Extract data</h4>
<p className="sk-cell-desc-sm">Pull structured data from any site without an API.</p>
<span className="sk-mono sk-arrow-sm">↗</span>
</a>
<a href="/docs/cookbooks/healthcare-portal-data" className="sk-bento-cell sk-bento-cell-link sk-bento-cell-sm sk-usecase-orange">
+ <span className="sk-usecase-icon">
+ <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round"><path d="M22 12h-4l-3 9L9 3l-3 9H2"/></svg>
+ </span>
<h4 className="sk-cell-title-sm">Healthcare portals</h4>
<p className="sk-cell-desc-sm">Extract patient demographics and billing from EHR portals.</p>
<span className="sk-mono sk-arrow-sm">↗</span>
</a>
</div>
+<div className="sk-bento-row sk-bento-4col">
+ <a href="/docs/multi-step-automations/build-a-workflow" className="sk-bento-cell sk-bento-cell-link sk-bento-cell-sm sk-usecase-orange">
+ <span className="sk-usecase-icon">
+ <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round"><circle cx="9" cy="21" r="1"/><circle cx="20" cy="21" r="1"/><path d="M1 1h4l2.68 13.39a2 2 0 0 0 2 1.61h9.72a2 2 0 0 0 2-1.61L23 6H6"/></svg>
+ </span>
+ <h4 className="sk-cell-title-sm">E-commerce purchasing</h4>
+ <p className="sk-cell-desc-sm">Search products, add to cart, and complete purchases on any store.</p>
+ <span className="sk-mono sk-arrow-sm">↗</span>
+ </a>
+ <a href="/docs/running-automations/run-a-task" className="sk-bento-cell sk-bento-cell-link sk-bento-cell-sm sk-usecase-teal">
+ <span className="sk-usecase-icon">
+ <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round"><path d="M3 21h18"/><path d="M5 21V7l8-4v18"/><path d="M19 21V11l-6-4"/><path d="M9 9h1"/><path d="M9 13h1"/><path d="M9 17h1"/></svg>
+ </span>
+ <h4 className="sk-cell-title-sm">Government forms</h4>
+ <p className="sk-cell-desc-sm">Navigate complex government websites to register accounts or file forms.</p>
+ <span className="sk-mono sk-arrow-sm">↗</span>
+ </a>
+ <a href="/docs/multi-step-automations/workflow-blocks-reference" className="sk-bento-cell sk-bento-cell-link sk-bento-cell-sm sk-usecase-orange">
+ <span className="sk-usecase-icon">
+ <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round"><path d="M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z"/></svg>
+ </span>
+ <h4 className="sk-cell-title-sm">Insurance quotes</h4>
+ <p className="sk-cell-desc-sm">Fill multi-step quote forms across providers in any language.</p>
+ <span className="sk-mono sk-arrow-sm">↗</span>
+ </a>
+ <a href="/docs/cookbooks/job-application-filler" className="sk-bento-cell sk-bento-cell-link sk-bento-cell-sm sk-usecase-teal">
+ <span className="sk-usecase-icon">
+ <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round"><rect x="2" y="3" width="20" height="14" rx="2" ry="2"/><line x1="8" y1="21" x2="16" y2="21"/><line x1="12" y1="17" x2="12" y2="21"/></svg>
+ </span>
+ <h4 className="sk-cell-title-sm">Job applications</h4>
+ <p className="sk-cell-desc-sm">Auto-fill and submit applications on Lever, Greenhouse, and more.</p>
+ <span className="sk-mono sk-arrow-sm">↗</span>
+ </a>
+</div>
+
{/* ===== FOOTER CTA ===== */}
<div className="sk-footer-cta">
diff --git a/docs/nav/api-reference.mdx b/docs/nav/api-reference.mdx
new file mode 100644
index 000000000..f6a88ccc9
--- /dev/null
+++ b/docs/nav/api-reference.mdx
@@ -0,0 +1,4 @@
+---
+title: "API Reference"
+url: "/api-reference"
+---
diff --git a/docs/nav/changelog.mdx b/docs/nav/changelog.mdx
new file mode 100644
index 000000000..357414099
--- /dev/null
+++ b/docs/nav/changelog.mdx
@@ -0,0 +1,4 @@
+---
+title: "Changelog"
+url: "/changelog"
+---
diff --git a/docs/nav/cloud-ui.mdx b/docs/nav/cloud-ui.mdx
new file mode 100644
index 000000000..31f8d533b
--- /dev/null
+++ b/docs/nav/cloud-ui.mdx
@@ -0,0 +1,4 @@
+---
+title: "Cloud UI"
+url: "/cloud/getting-started/overview"
+---
diff --git a/docs/nav/cookbooks.mdx b/docs/nav/cookbooks.mdx
new file mode 100644
index 000000000..d037c0ba7
--- /dev/null
+++ b/docs/nav/cookbooks.mdx
@@ -0,0 +1,4 @@
+---
+title: "Cookbooks"
+url: "/cookbooks/overview"
+---
diff --git a/docs/nav/developers.mdx b/docs/nav/developers.mdx
new file mode 100644
index 000000000..94b363291
--- /dev/null
+++ b/docs/nav/developers.mdx
@@ -0,0 +1,4 @@
+---
+title: "Developers"
+url: "/running-automations/run-a-task"
+---
diff --git a/docs/nav/getting-started.mdx b/docs/nav/getting-started.mdx
new file mode 100644
index 000000000..6074eb4ca
--- /dev/null
+++ b/docs/nav/getting-started.mdx
@@ -0,0 +1,4 @@
+---
+title: "Getting Started"
+url: "/getting-started/introduction"
+---
diff --git a/docs/nav/sdk-reference.mdx b/docs/nav/sdk-reference.mdx
new file mode 100644
index 000000000..40355fe5f
--- /dev/null
+++ b/docs/nav/sdk-reference.mdx
@@ -0,0 +1,4 @@
+---
+title: "SDK Reference"
+url: "/sdk-reference/overview"
+---
diff --git a/docs/snippets/api-key-prompt.jsx b/docs/snippets/api-key-prompt.jsx
new file mode 100644
index 000000000..5e62e995d
--- /dev/null
+++ b/docs/snippets/api-key-prompt.jsx
@@ -0,0 +1,103 @@
+function dedent(text) {
+ if (typeof text !== "string") return String(text);
+ var lines = text.split("\n");
+ var indents = [];
+ for (var i = 1; i < lines.length; i++) {
+ if (lines[i].trim().length > 0) {
+ var match = lines[i].match(/^(\s*)/);
+ indents.push(match ? match[1].length : 0);
+ }
+ }
+ var min = indents.length > 0 ? Math.min.apply(null, indents) : 0;
+ if (min === 0) return text;
+ return lines
+ .map(function (line, i) {
+ return i === 0 ? line : line.slice(min);
+ })
+ .join("\n");
+}
+
+export const ApiKeyPrompt = ({ children }) => {
+ const [apiKey, setApiKey] = React.useState("");
+ const [copied, setCopied] = React.useState(false);
+
+ const raw = dedent(children);
+ const content = apiKey
+ ? raw.replace(/PASTE_YOUR_API_KEY_HERE/g, apiKey)
+ : raw;
+
+ const handleCopy = async () => {
+ await navigator.clipboard.writeText(content);
+ setCopied(true);
+ setTimeout(() => setCopied(false), 2000);
+ };
+
+ return (
+ <div>
+ <input
+ type="text"
+ placeholder="Paste your Skyvern API key"
+ value={apiKey}
+ onChange={(e) => setApiKey(e.target.value)}
+ spellCheck={false}
+ autoComplete="off"
+ style={{
+ width: "100%",
+ padding: "10px 14px",
+ marginBottom: "12px",
+ borderRadius: "8px",
+ border: "1px solid var(--border, #d1d5db)",
+ fontSize: "14px",
+ fontFamily:
+ "ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace",
+ backgroundColor: "var(--background, transparent)",
+ color: "inherit",
+ outline: "none",
+ boxSizing: "border-box",
+ }}
+ />
+ <div
+ style={{
+ position: "relative",
+ borderRadius: "8px",
+ overflow: "hidden",
+ }}
+ >
+ <button
+ onClick={handleCopy}
+ style={{
+ position: "absolute",
+ top: "10px",
+ right: "10px",
+ padding: "4px 12px",
+ fontSize: "12px",
+ borderRadius: "6px",
+ border: "none",
+ backgroundColor: "rgba(255, 255, 255, 0.1)",
+ color: "#a1a1aa",
+ cursor: "pointer",
+ zIndex: 1,
+ transition: "color 0.15s ease",
+ }}
+ onMouseEnter={(e) => (e.currentTarget.style.color = "#e5e7eb")}
+ onMouseLeave={(e) => (e.currentTarget.style.color = "#a1a1aa")}
+ >
+ {copied ? "Copied!" : "Copy"}
+ </button>
+ <pre
+ style={{
+ margin: 0,
+ padding: "16px",
+ overflowX: "auto",
+ fontSize: "13px",
+ lineHeight: "1.7",
+ backgroundColor: "#0d1117",
+ color: "#e6edf3",
+ }}
+ >
+ <code>{content}</code>
+ </pre>
+ </div>
+ </div>
+ );
+};
diff --git a/docs/snippets/introduction-content.mdx b/docs/snippets/introduction-content.mdx
index fd513389b..1c1c30e7e 100644
--- a/docs/snippets/introduction-content.mdx
+++ b/docs/snippets/introduction-content.mdx
@@ -24,7 +24,7 @@ A typical task takes 2 to 10 steps. You can set `max_steps` to cap cost during d
For anything beyond simple single-page tasks, Skyvern 2.0 wraps the agent loop in a higher-level system with three components:
-<img src="/images/skyvern-system-architecture.png" alt="Skyvern 2.0 architecture: Planner breaks prompt into sub-tasks, Task Agent executes them, Validator confirms completion" />
+<img src="/images/skyvern-explainer.png" alt="Skyvern 2.0 architecture: Planner breaks prompt into sub-tasks, Task Agent executes them, Validator confirms completion" />
The **Planner** takes your prompt and breaks it into an ordered sequence of sub-tasks. If you say "log into the vendor portal, download all invoices from January, and save them as PDFs," the Planner sequences that into: navigate to login → authenticate → find the invoice section → loop through January invoices → download each one.
diff --git a/docs/style.css b/docs/style.css
index bdeec833a..b6267f5b1 100644
--- a/docs/style.css
+++ b/docs/style.css
@@ -5,486 +5,531 @@
/* --- Brand Tokens (navy product palette + warm landing page) --- */
:root {
- --sk-cream: #F8F5EF;
- --sk-cream-dark: #EFEBE4;
- --sk-navy: #1B2559;
- --sk-navy-light: #2B3674;
- --sk-navy-faint: #EEF0F8;
- --sk-blue: #4A6CF7;
- --sk-blue-light: #7B93FA;
- --sk-dark: #1B2559;
- --sk-dark-hover: #2B3674;
- --sk-charcoal: #1B2038;
- --sk-text-muted: #68697B;
- --sk-border: #D6CEC4;
- --sk-border-hover: #4A6CF7;
- --sk-shadow: 0 1px 3px rgba(0, 0, 0, 0.04), 0 1px 2px rgba(0, 0, 0, 0.03);
- --sk-shadow-hover: 0 4px 12px rgba(27, 37, 89, 0.1), 0 2px 4px rgba(0, 0, 0, 0.04);
- --sk-radius: 10px;
- --sk-mono: "JetBrains Mono", "Fira Code", "SF Mono", "Cascadia Code", monospace;
+ --sk-cream: #f8f5ef;
+ --sk-cream-dark: #efebe4;
+ --sk-navy: #1b2559;
+ --sk-navy-light: #2b3674;
+ --sk-navy-faint: #eef0f8;
+ --sk-blue: #4a6cf7;
+ --sk-blue-light: #7b93fa;
+ --sk-dark: #1b2559;
+ --sk-dark-hover: #2b3674;
+ --sk-charcoal: #1b2038;
+ --sk-text-muted: #68697b;
+ --sk-border: #d6cec4;
+ --sk-border-hover: #4a6cf7;
+ --sk-shadow: 0 1px 3px rgba(0, 0, 0, 0.04), 0 1px 2px rgba(0, 0, 0, 0.03);
+ --sk-shadow-hover:
+ 0 4px 12px rgba(27, 37, 89, 0.1), 0 2px 4px rgba(0, 0, 0, 0.04);
+ --sk-radius: 10px;
+ --sk-mono:
+ "JetBrains Mono", "Fira Code", "SF Mono", "Cascadia Code", monospace;
}
-
/* =============================================
HOMEPAGE — Page wrapper (horizontal padding)
============================================= */
.sk-page {
- max-width: 1100px;
- margin: 0 auto;
- padding: 0 40px;
+ max-width: 1100px;
+ margin: 0 auto;
+ padding: 0 40px;
}
@media (max-width: 600px) {
- .sk-page {
- padding: 0 20px;
- }
+ .sk-page {
+ padding: 0 20px;
+ }
}
-
/* =============================================
HOMEPAGE — Hero
============================================= */
.sk-hero {
- border: 1px solid var(--sk-border);
- border-radius: 2px;
- margin-bottom: 1px;
- position: relative;
- overflow: hidden;
+ border: 1px solid var(--sk-border);
+ border-radius: 2px;
+ margin-bottom: 1px;
+ position: relative;
+ overflow: hidden;
}
/* Version badge */
.sk-version-badge {
- font-family: var(--sk-mono) !important;
- font-size: 10px !important;
- letter-spacing: 0.04em !important;
- padding: 3px 8px !important;
- border-radius: 3px !important;
- border: 1px solid var(--sk-border) !important;
- color: var(--sk-blue) !important;
- text-decoration: none !important;
- transition: border-color 0.15s ease !important;
+ font-family: var(--sk-mono) !important;
+ font-size: 10px !important;
+ letter-spacing: 0.04em !important;
+ padding: 3px 8px !important;
+ border-radius: 3px !important;
+ border: 1px solid var(--sk-border) !important;
+ color: var(--sk-blue) !important;
+ text-decoration: none !important;
+ transition: border-color 0.15s ease !important;
}
.sk-version-badge:hover {
- border-color: var(--sk-blue) !important;
+ border-color: var(--sk-blue) !important;
}
.sk-hero-inner {
- display: grid;
- grid-template-columns: 1fr 1fr;
- gap: 0;
- min-height: 380px;
+ display: grid;
+ grid-template-columns: 1fr 1fr;
+ gap: 0;
+ min-height: 380px;
}
.sk-hero-left {
- padding: 48px 40px;
- display: flex;
- flex-direction: column;
- justify-content: center;
+ padding: 48px 40px;
+ display: flex;
+ flex-direction: column;
+ justify-content: center;
}
.sk-hero-right {
- padding: 32px 40px 32px 0;
- display: flex;
- align-items: center;
- justify-content: center;
- border-left: 1px solid var(--sk-border);
+ padding: 32px 40px 32px 0;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ border-left: 1px solid var(--sk-border);
}
.sk-hero-title {
- font-size: 38px;
- font-weight: 700;
- line-height: 1.12;
- letter-spacing: -0.03em;
- margin: 0 0 16px 0;
- color: var(--sk-charcoal);
+ font-size: 38px;
+ font-weight: 700;
+ line-height: 1.12;
+ letter-spacing: -0.03em;
+ margin: 0 0 16px 0;
+ color: var(--sk-charcoal);
}
.sk-hero-accent {
- color: var(--sk-blue);
- font-style: italic;
+ color: var(--sk-blue);
+ font-style: italic;
}
.sk-hero-sub {
- font-size: 16px;
- line-height: 1.6;
- color: var(--sk-text-muted);
- margin: 0 0 28px 0;
- max-width: 440px;
+ font-size: 16px;
+ line-height: 1.6;
+ color: var(--sk-text-muted);
+ margin: 0 0 28px 0;
+ max-width: 440px;
}
.sk-hero-actions {
- display: flex;
- gap: 12px;
- flex-wrap: wrap;
+ display: flex;
+ gap: 12px;
+ flex-wrap: wrap;
}
/* --- Monospace utility --- */
.sk-mono {
- font-family: var(--sk-mono) !important;
- font-size: 11px !important;
- letter-spacing: 0.04em !important;
+ font-family: var(--sk-mono) !important;
+ font-size: 11px !important;
+ letter-spacing: 0.04em !important;
}
/* --- Label (section markers like "01 — NO CODE") --- */
.sk-label {
- font-family: var(--sk-mono) !important;
- font-size: 11px !important;
- font-weight: 500 !important;
- letter-spacing: 0.08em !important;
- text-transform: uppercase !important;
- color: var(--sk-text-muted) !important;
- margin: 0 0 12px 0 !important;
+ font-family: var(--sk-mono) !important;
+ font-size: 11px !important;
+ font-weight: 500 !important;
+ letter-spacing: 0.08em !important;
+ text-transform: uppercase !important;
+ color: var(--sk-text-muted) !important;
+ margin: 0 0 12px 0 !important;
}
/* --- Terminal block --- */
.sk-terminal {
- width: 100%;
- max-width: 360px;
- border: 1px solid var(--sk-border);
- border-radius: 6px;
- overflow: hidden;
- background: var(--sk-charcoal);
+ width: 100%;
+ max-width: 360px;
+ border: 1px solid var(--sk-border);
+ border-radius: 6px;
+ overflow: hidden;
+ background: var(--sk-charcoal);
}
.sk-terminal-bar {
- display: flex;
- align-items: center;
- gap: 6px;
- padding: 10px 14px;
- background: #1a1a1a;
- border-bottom: 1px solid #333;
+ display: flex;
+ align-items: center;
+ gap: 6px;
+ padding: 10px 14px;
+ background: #1a1a1a;
+ border-bottom: 1px solid #333;
}
.sk-dot {
- width: 10px;
- height: 10px;
- border-radius: 50%;
+ width: 10px;
+ height: 10px;
+ border-radius: 50%;
+}
+.sk-dot-red {
+ background: #ff5f56;
+}
+.sk-dot-yellow {
+ background: #ffbd2e;
+}
+.sk-dot-green {
+ background: #27c93f;
}
-.sk-dot-red { background: #ff5f56; }
-.sk-dot-yellow { background: #ffbd2e; }
-.sk-dot-green { background: #27c93f; }
.sk-terminal-title {
- font-family: var(--sk-mono);
- font-size: 11px;
- color: #888;
- margin-left: 8px;
+ font-family: var(--sk-mono);
+ font-size: 11px;
+ color: #888;
+ margin-left: 8px;
}
.sk-terminal-body {
- padding: 14px 16px;
+ padding: 14px 16px;
}
.sk-terminal-body p {
- margin: 0 0 4px 0 !important;
- font-size: 11.5px !important;
- line-height: 1.6 !important;
- color: #ccc;
+ margin: 0 0 4px 0 !important;
+ font-size: 11.5px !important;
+ line-height: 1.6 !important;
+ color: #ccc;
}
-.sk-t-teal { color: #7B93FA !important; }
-.sk-t-orange { color: #F7C948 !important; }
-.sk-t-muted { color: #555 !important; }
+.sk-t-teal {
+ color: #7b93fa !important;
+}
+.sk-t-orange {
+ color: #f7c948 !important;
+}
+.sk-t-muted {
+ color: #555 !important;
+}
/* Blinking cursor */
.sk-cursor {
- animation: sk-blink 1s step-end infinite;
- color: #7B93FA;
+ animation: sk-blink 1s step-end infinite;
+ color: #7b93fa;
}
@keyframes sk-blink {
- 0%, 100% { opacity: 1; }
- 50% { opacity: 0; }
+ 0%,
+ 100% {
+ opacity: 1;
+ }
+ 50% {
+ opacity: 0;
+ }
}
-
/* =============================================
HOMEPAGE — Bento Grid System
============================================= */
.sk-bento-row {
- display: grid;
- gap: 1px;
- margin-bottom: 1px;
+ display: grid;
+ gap: 1px;
+ margin-bottom: 1px;
}
-.sk-bento-3col { grid-template-columns: repeat(3, 1fr); }
-.sk-bento-2col { grid-template-columns: repeat(2, 1fr); }
-.sk-bento-4col { grid-template-columns: repeat(4, 1fr); }
+.sk-bento-3col {
+ grid-template-columns: repeat(3, 1fr);
+}
+.sk-bento-2col {
+ grid-template-columns: repeat(2, 1fr);
+}
+.sk-bento-4col {
+ grid-template-columns: repeat(4, 1fr);
+}
.sk-bento-cell {
- border: 1px solid var(--sk-border);
- border-radius: 2px;
- padding: 28px 24px;
- background: transparent;
- position: relative;
- transition: background-color 0.15s ease;
+ border: 1px solid var(--sk-border);
+ border-radius: 2px;
+ padding: 28px 24px;
+ background: transparent;
+ position: relative;
+ transition: background-color 0.15s ease;
}
.sk-bento-cell:hover {
- background-color: rgba(74, 108, 247, 0.03);
+ background-color: rgba(74, 108, 247, 0.03);
}
/* Linked cells */
a.sk-bento-cell-link {
- text-decoration: none !important;
- color: inherit !important;
- display: block;
+ text-decoration: none !important;
+ color: inherit !important;
+ display: block;
}
a.sk-bento-cell-link:hover {
- background-color: rgba(74, 108, 247, 0.04);
+ background-color: rgba(74, 108, 247, 0.04);
}
a.sk-bento-cell-link:hover .sk-arrow-lg,
a.sk-bento-cell-link:hover .sk-arrow-sm {
- color: var(--sk-blue) !important;
+ color: var(--sk-blue) !important;
}
/* --- Cell typography --- */
.sk-cell-title {
- font-size: 17px;
- font-weight: 600;
- margin: 0 0 6px 0;
- color: var(--sk-charcoal);
+ font-size: 17px;
+ font-weight: 600;
+ margin: 0 0 6px 0;
+ color: var(--sk-charcoal);
}
.sk-cell-desc {
- font-size: 14px;
- color: var(--sk-text-muted);
- margin: 0 0 20px 0;
- line-height: 1.5;
+ font-size: 14px;
+ color: var(--sk-text-muted);
+ margin: 0 0 20px 0;
+ line-height: 1.5;
}
.sk-cell-title-sm {
- font-size: 14px;
- font-weight: 600;
- margin: 0 0 4px 0;
- color: var(--sk-charcoal);
+ font-size: 14px;
+ font-weight: 600;
+ margin: 0 0 4px 0;
+ color: var(--sk-charcoal);
}
.sk-cell-desc-sm {
- font-size: 13px;
- color: var(--sk-text-muted);
- margin: 0;
- line-height: 1.5;
+ font-size: 13px;
+ color: var(--sk-text-muted);
+ margin: 0;
+ line-height: 1.5;
}
.sk-bento-cell-sm {
- padding: 20px;
+ padding: 20px;
}
/* --- Links inside cells --- */
.sk-cell-links {
- display: flex;
- flex-direction: column;
- gap: 2px;
+ display: flex;
+ flex-direction: column;
+ gap: 2px;
}
.sk-cell-link {
- display: flex;
- align-items: center;
- justify-content: space-between;
- padding: 7px 10px;
- font-size: 13.5px;
- font-weight: 500;
- color: var(--sk-charcoal) !important;
- text-decoration: none !important;
- border-radius: 3px;
- transition: background-color 0.12s ease, color 0.12s ease;
- border-bottom: none !important;
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ padding: 7px 10px;
+ font-size: 13.5px;
+ font-weight: 500;
+ color: var(--sk-charcoal) !important;
+ text-decoration: none !important;
+ border-radius: 3px;
+ transition:
+ background-color 0.12s ease,
+ color 0.12s ease;
+ border-bottom: none !important;
}
.sk-cell-link:hover {
- background-color: rgba(74, 108, 247, 0.06);
- color: var(--sk-blue) !important;
+ background-color: rgba(74, 108, 247, 0.06);
+ color: var(--sk-blue) !important;
}
/* --- Arrows --- */
.sk-arrow {
- font-family: var(--sk-mono);
- font-size: 12px;
- opacity: 0.35;
- transition: opacity 0.12s ease, color 0.12s ease;
+ font-family: var(--sk-mono);
+ font-size: 12px;
+ opacity: 0.35;
+ transition:
+ opacity 0.12s ease,
+ color 0.12s ease;
}
.sk-cell-link:hover .sk-arrow {
- opacity: 1;
- color: var(--sk-blue);
+ opacity: 1;
+ color: var(--sk-blue);
}
.sk-arrow-lg {
- font-family: var(--sk-mono) !important;
- font-size: 18px !important;
- position: absolute;
- top: 24px;
- right: 24px;
- opacity: 0.25;
- transition: opacity 0.15s ease;
- color: var(--sk-text-muted) !important;
+ font-family: var(--sk-mono) !important;
+ font-size: 18px !important;
+ position: absolute;
+ top: 24px;
+ right: 24px;
+ opacity: 0.25;
+ transition: opacity 0.15s ease;
+ color: var(--sk-text-muted) !important;
}
.sk-arrow-sm {
- font-family: var(--sk-mono) !important;
- font-size: 14px !important;
- position: absolute;
- top: 16px;
- right: 16px;
- opacity: 0.25;
- transition: opacity 0.15s ease;
- color: var(--sk-text-muted) !important;
+ font-family: var(--sk-mono) !important;
+ font-size: 14px !important;
+ position: absolute;
+ top: 16px;
+ right: 16px;
+ opacity: 0.25;
+ transition: opacity 0.15s ease;
+ color: var(--sk-text-muted) !important;
}
-
/* =============================================
HOMEPAGE — Buttons
============================================= */
.sk-btn-primary {
- display: inline-flex !important;
- align-items: center !important;
- padding: 11px 22px !important;
- border-radius: 6px !important;
- background-color: var(--sk-dark) !important;
- color: #fff !important;
- font-size: 14px !important;
- font-weight: 600 !important;
- text-decoration: none !important;
- transition: background-color 0.15s ease !important;
- border: none !important;
+ display: inline-flex !important;
+ align-items: center !important;
+ padding: 11px 22px !important;
+ border-radius: 6px !important;
+ background-color: var(--sk-dark) !important;
+ color: #fff !important;
+ font-size: 14px !important;
+ font-weight: 600 !important;
+ text-decoration: none !important;
+ transition: background-color 0.15s ease !important;
+ border: none !important;
}
.sk-btn-primary:hover {
- background-color: var(--sk-dark-hover) !important;
+ background-color: var(--sk-dark-hover) !important;
}
.sk-btn-secondary {
- display: inline-flex !important;
- align-items: center !important;
- padding: 11px 22px !important;
- border-radius: 4px !important;
- background-color: transparent !important;
- color: var(--sk-charcoal) !important;
- font-size: 14px !important;
- font-weight: 600 !important;
- text-decoration: none !important;
- border: 1px solid var(--sk-border) !important;
- transition: border-color 0.15s ease, color 0.15s ease !important;
+ display: inline-flex !important;
+ align-items: center !important;
+ padding: 11px 22px !important;
+ border-radius: 4px !important;
+ background-color: transparent !important;
+ color: var(--sk-charcoal) !important;
+ font-size: 14px !important;
+ font-weight: 600 !important;
+ text-decoration: none !important;
+ border: 1px solid var(--sk-border) !important;
+ transition:
+ border-color 0.15s ease,
+ color 0.15s ease !important;
}
.sk-btn-secondary:hover {
- border-color: var(--sk-blue) !important;
- color: var(--sk-charcoal) !important;
+ border-color: var(--sk-blue) !important;
+ color: var(--sk-charcoal) !important;
}
-
/* --- Use case left-border accents --- */
.sk-usecase-teal {
- border-left: 3px solid var(--sk-blue) !important;
+ border-left: 3px solid var(--sk-blue) !important;
}
.sk-usecase-orange {
- border-left: 3px solid var(--sk-dark) !important;
+ border-left: 3px solid var(--sk-dark) !important;
+}
+
+.sk-usecase-icon {
+ display: inline-flex;
+ align-items: center;
+ justify-content: center;
+ width: 32px;
+ height: 32px;
+ border-radius: 6px;
+ background: rgba(0, 0, 0, 0.04);
+ margin-bottom: 8px;
+ color: var(--sk-text-muted);
}
+.sk-usecase-teal .sk-usecase-icon {
+ color: var(--sk-blue);
+ background: rgba(0, 191, 255, 0.08);
+}
+
+.sk-usecase-orange .sk-usecase-icon {
+ color: var(--sk-dark);
+ background: rgba(0, 0, 0, 0.06);
+}
/* =============================================
HOMEPAGE — Footer CTA
============================================= */
.sk-footer-cta {
- border: 1px solid var(--sk-border);
- border-radius: 2px;
- margin-top: 1px;
- padding: 20px 24px;
+ border: 1px solid var(--sk-border);
+ border-radius: 2px;
+ margin-top: 1px;
+ padding: 20px 24px;
}
.sk-footer-cta-inner {
- display: flex;
- align-items: center;
- justify-content: space-between;
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
}
.sk-footer-cta-text {
- font-size: 14px;
- font-weight: 500;
- color: var(--sk-charcoal);
- margin: 0;
+ font-size: 14px;
+ font-weight: 500;
+ color: var(--sk-charcoal);
+ margin: 0;
}
.sk-footer-cta-links {
- display: flex;
- gap: 16px;
+ display: flex;
+ gap: 16px;
}
.sk-footer-link {
- font-family: var(--sk-mono) !important;
- font-size: 12px !important;
- letter-spacing: 0.04em !important;
- color: var(--sk-text-muted) !important;
- text-decoration: none !important;
- transition: color 0.15s ease !important;
- border-bottom: none !important;
+ font-family: var(--sk-mono) !important;
+ font-size: 12px !important;
+ letter-spacing: 0.04em !important;
+ color: var(--sk-text-muted) !important;
+ text-decoration: none !important;
+ transition: color 0.15s ease !important;
+ border-bottom: none !important;
}
.sk-footer-link:hover {
- color: var(--sk-blue) !important;
+ color: var(--sk-blue) !important;
}
@media (max-width: 600px) {
- .sk-footer-cta-inner {
- flex-direction: column;
- gap: 12px;
- text-align: center;
- }
+ .sk-footer-cta-inner {
+ flex-direction: column;
+ gap: 12px;
+ text-align: center;
+ }
}
-
/* =============================================
RESPONSIVE
============================================= */
@media (max-width: 900px) {
- .sk-hero {
- margin-top: 130px;
- }
- .sk-hero-inner {
- grid-template-columns: 1fr;
- }
- .sk-hero-right {
- border-left: none;
- border-top: 1px solid var(--sk-border);
- padding: 24px;
- }
- .sk-bento-3col {
- grid-template-columns: 1fr;
- }
- .sk-bento-4col {
- grid-template-columns: repeat(2, 1fr);
- }
+ .sk-hero {
+ margin-top: 130px;
+ }
+ .sk-hero-inner {
+ grid-template-columns: 1fr;
+ }
+ .sk-hero-right {
+ border-left: none;
+ border-top: 1px solid var(--sk-border);
+ padding: 24px;
+ }
+ .sk-bento-3col {
+ grid-template-columns: 1fr;
+ }
+ .sk-bento-4col {
+ grid-template-columns: repeat(2, 1fr);
+ }
}
@media (max-width: 600px) {
- .sk-bento-2col,
- .sk-bento-4col {
- grid-template-columns: 1fr;
- }
- .sk-hero-left {
- padding: 32px 24px;
- }
- .sk-hero-title {
- font-size: 28px;
- }
+ .sk-bento-2col,
+ .sk-bento-4col {
+ grid-template-columns: 1fr;
+ }
+ .sk-hero-left {
+ padding: 32px 24px;
+ }
+ .sk-hero-title {
+ font-size: 28px;
+ }
}
-
/* =============================================
EXISTING — Cards, Tables, Links, etc.
(non-homepage styles)
@@ -492,307 +537,315 @@ a.sk-bento-cell-link:hover .sk-arrow-sm {
[class*="Card"],
.card {
- border: 1px solid var(--sk-border) !important;
- border-radius: 12px !important;
- box-shadow: var(--sk-shadow) !important;
- transition: box-shadow 0.2s ease, border-color 0.2s ease !important;
+ border: 1px solid var(--sk-border) !important;
+ border-radius: 12px !important;
+ box-shadow: var(--sk-shadow) !important;
+ transition:
+ box-shadow 0.2s ease,
+ border-color 0.2s ease !important;
}
[class*="Card"]:hover,
.card:hover {
- box-shadow: var(--sk-shadow-hover) !important;
- border-color: var(--sk-border-hover) !important;
+ box-shadow: var(--sk-shadow-hover) !important;
+ border-color: var(--sk-border-hover) !important;
}
article img {
- border: 1px solid var(--sk-border) !important;
- border-radius: var(--sk-radius) !important;
- box-shadow: var(--sk-shadow) !important;
+ border: 1px solid var(--sk-border) !important;
+ border-radius: var(--sk-radius) !important;
+ box-shadow: var(--sk-shadow) !important;
}
table {
- border-color: var(--sk-border) !important;
- border-radius: var(--sk-radius) !important;
- overflow: hidden;
+ border-color: var(--sk-border) !important;
+ border-radius: var(--sk-radius) !important;
+ overflow: hidden;
}
th {
- background-color: var(--sk-cream-dark) !important;
- border-color: var(--sk-border) !important;
- color: var(--sk-charcoal) !important;
- font-weight: 600 !important;
+ background-color: var(--sk-cream-dark) !important;
+ border-color: var(--sk-border) !important;
+ color: var(--sk-charcoal) !important;
+ font-weight: 600 !important;
}
td {
- border-color: var(--sk-border) !important;
+ border-color: var(--sk-border) !important;
}
tr:nth-child(even) td {
- background-color: rgba(250, 246, 241, 0.5) !important;
+ background-color: rgba(250, 246, 241, 0.5) !important;
}
article a:not([class]) {
- color: var(--sk-blue) !important;
- text-decoration: none !important;
- border-bottom: 1px solid transparent !important;
- transition: color 0.15s ease, border-color 0.15s ease !important;
+ color: var(--sk-blue) !important;
+ text-decoration: none !important;
+ border-bottom: 1px solid transparent !important;
+ transition:
+ color 0.15s ease,
+ border-color 0.15s ease !important;
}
article a:not([class]):hover {
- color: var(--sk-dark) !important;
- border-bottom-color: var(--sk-dark) !important;
+ color: var(--sk-dark) !important;
+ border-bottom-color: var(--sk-dark) !important;
}
[class*="callout"],
[class*="Callout"],
[class*="note"],
[class*="Note"] {
- border-left-color: var(--sk-blue) !important;
- border-radius: 0 var(--sk-radius) var(--sk-radius) 0 !important;
- background-color: var(--sk-navy-faint) !important;
+ border-left-color: var(--sk-blue) !important;
+ border-radius: 0 var(--sk-radius) var(--sk-radius) 0 !important;
+ background-color: var(--sk-navy-faint) !important;
}
[class*="warning"],
[class*="Warning"] {
- border-left-color: #E5A236 !important;
- background-color: #FEF9EE !important;
+ border-left-color: #e5a236 !important;
+ background-color: #fef9ee !important;
}
[class*="Accordion"],
[class*="accordion"],
details {
- border-color: var(--sk-border) !important;
- border-radius: var(--sk-radius) !important;
+ border-color: var(--sk-border) !important;
+ border-radius: var(--sk-radius) !important;
}
hr {
- border: none !important;
- height: 1px !important;
- background: linear-gradient(90deg, transparent 0%, var(--sk-blue-light) 20%, var(--sk-blue) 50%, var(--sk-blue-light) 80%, transparent 100%) !important;
- opacity: 0.3 !important;
- margin: 2rem 0 !important;
+ border: none !important;
+ height: 1px !important;
+ background: linear-gradient(
+ 90deg,
+ transparent 0%,
+ var(--sk-blue-light) 20%,
+ var(--sk-blue) 50%,
+ var(--sk-blue-light) 80%,
+ transparent 100%
+ ) !important;
+ opacity: 0.3 !important;
+ margin: 2rem 0 !important;
}
[class*="Step"] [class*="number"],
[class*="step"] [class*="number"],
[class*="Steps"] [class*="indicator"] {
- background-color: var(--sk-blue) !important;
- color: white !important;
+ background-color: var(--sk-blue) !important;
+ color: white !important;
}
[data-active="true"],
[aria-current="page"] {
- color: var(--sk-blue) !important;
+ color: var(--sk-blue) !important;
}
#navbar,
nav[class*="Navbar"],
header[class*="header"] {
- border-bottom: 1px solid var(--sk-border) !important;
+ border-bottom: 1px solid var(--sk-border) !important;
}
::selection {
- background-color: rgba(74, 108, 247, 0.15);
+ background-color: rgba(74, 108, 247, 0.15);
}
::-webkit-scrollbar {
- width: 6px;
- height: 6px;
+ width: 6px;
+ height: 6px;
}
::-webkit-scrollbar-track {
- background: var(--sk-cream);
+ background: var(--sk-cream);
}
::-webkit-scrollbar-thumb {
- background: var(--sk-border);
- border-radius: 3px;
+ background: var(--sk-border);
+ border-radius: 3px;
}
::-webkit-scrollbar-thumb:hover {
- background: var(--sk-blue-light);
+ background: var(--sk-blue-light);
}
-
/* =============================================
CHANGELOG — Custom Layout
============================================= */
.cl-page {
- position: relative;
- max-width: 860px;
- margin: 0 auto;
- padding: 48px 40px 80px;
+ position: relative;
+ max-width: 860px;
+ margin: 0 auto;
+ padding: 48px 40px 80px;
}
/* --- Sidebar nav --- */
.cl-sidebar {
- display: block !important;
- position: fixed;
- top: 140px;
- left: max(20px, calc(50% - 430px - 200px));
- width: 180px;
+ display: block !important;
+ position: fixed;
+ top: 140px;
+ left: max(20px, calc(50% - 430px - 200px));
+ width: 180px;
}
.cl-sidebar-title {
- font-family: var(--sk-mono) !important;
- font-size: 11px !important;
- font-weight: 600 !important;
- letter-spacing: 0.06em !important;
- text-transform: uppercase !important;
- color: var(--sk-text-muted) !important;
- margin: 0 0 12px 0 !important;
+ font-family: var(--sk-mono) !important;
+ font-size: 11px !important;
+ font-weight: 600 !important;
+ letter-spacing: 0.06em !important;
+ text-transform: uppercase !important;
+ color: var(--sk-text-muted) !important;
+ margin: 0 0 12px 0 !important;
}
.cl-sidebar-link {
- display: block;
- font-size: 13px;
- line-height: 1.4;
- color: var(--sk-text-muted) !important;
- text-decoration: none !important;
- padding: 6px 0;
- border-bottom: none !important;
- transition: color 0.15s ease;
+ display: block;
+ font-size: 13px;
+ line-height: 1.4;
+ color: var(--sk-text-muted) !important;
+ text-decoration: none !important;
+ padding: 6px 0;
+ border-bottom: none !important;
+ transition: color 0.15s ease;
}
.cl-sidebar-link:hover {
- color: var(--sk-blue) !important;
+ color: var(--sk-blue) !important;
}
/* --- Content area --- */
.cl-content {
- min-width: 0;
+ min-width: 0;
}
.cl-title {
- font-size: 32px;
- font-weight: 700;
- letter-spacing: -0.02em;
- color: #0f172a;
- margin: 0 0 8px 0;
+ font-size: 32px;
+ font-weight: 700;
+ letter-spacing: -0.02em;
+ color: #0f172a;
+ margin: 0 0 8px 0;
}
.cl-subtitle {
- font-size: 16px;
- color: #64748b;
- margin: 0 0 40px 0;
+ font-size: 16px;
+ color: #64748b;
+ margin: 0 0 40px 0;
}
/* --- Text colour inside Update blocks --- */
.cl-content h2 {
- color: #0f172a !important;
+ color: #0f172a !important;
}
.cl-content li,
.cl-content p {
- color: #334155 !important;
+ color: #334155 !important;
}
.cl-content li strong {
- color: #0f172a !important;
+ color: #0f172a !important;
}
/* --- Bullets and spacing inside Update blocks --- */
.cl-content ul {
- padding-left: 24px !important;
- list-style-type: disc !important;
+ padding-left: 24px !important;
+ list-style-type: disc !important;
}
.cl-content li {
- margin-bottom: 8px;
- line-height: 1.7;
- display: list-item !important;
- list-style-type: disc !important;
+ margin-bottom: 8px;
+ line-height: 1.7;
+ display: list-item !important;
+ list-style-type: disc !important;
}
/* --- Dark mode overrides for changelog text --- */
.dark .cl-title,
[data-theme="dark"] .cl-title {
- color: #f1f5f9;
+ color: #f1f5f9;
}
.dark .cl-subtitle,
[data-theme="dark"] .cl-subtitle {
- color: #94a3b8;
+ color: #94a3b8;
}
.dark .cl-content h2,
[data-theme="dark"] .cl-content h2 {
- color: #f1f5f9 !important;
+ color: #f1f5f9 !important;
}
.dark .cl-content li,
.dark .cl-content p,
[data-theme="dark"] .cl-content li,
[data-theme="dark"] .cl-content p {
- color: #cbd5e1 !important;
+ color: #cbd5e1 !important;
}
.dark .cl-content li strong,
[data-theme="dark"] .cl-content li strong {
- color: #f1f5f9 !important;
+ color: #f1f5f9 !important;
}
/* --- Responsive --- */
@media (max-width: 1100px) {
- .cl-sidebar {
- display: none !important;
- }
+ .cl-sidebar {
+ display: none !important;
+ }
- .cl-page {
- padding: 48px 20px 60px;
- }
+ .cl-page {
+ padding: 48px 20px 60px;
+ }
- .cl-title {
- font-size: 26px;
- }
+ .cl-title {
+ font-size: 26px;
+ }
- .cl-subtitle {
- margin-bottom: 24px;
- }
+ .cl-subtitle {
+ margin-bottom: 24px;
+ }
}
-
/* =============================================
DARK MODE
============================================= */
.dark,
[data-theme="dark"] {
- --sk-cream: #1C1917;
- --sk-cream-dark: #252220;
- --sk-navy-faint: rgba(74, 108, 247, 0.08);
- --sk-dark: #7B93FA;
- --sk-dark-hover: #93A7FB;
- --sk-charcoal: #F5F0EB;
- --sk-text-muted: #A8A29E;
- --sk-border: #2E2A26;
- --sk-border-hover: #4A6CF7;
- --sk-shadow: 0 1px 3px rgba(0, 0, 0, 0.2);
- --sk-shadow-hover: 0 4px 12px rgba(0, 0, 0, 0.3);
+ --sk-cream: #1c1917;
+ --sk-cream-dark: #252220;
+ --sk-navy-faint: rgba(74, 108, 247, 0.08);
+ --sk-dark: #7b93fa;
+ --sk-dark-hover: #93a7fb;
+ --sk-charcoal: #f5f0eb;
+ --sk-text-muted: #a8a29e;
+ --sk-border: #2e2a26;
+ --sk-border-hover: #4a6cf7;
+ --sk-shadow: 0 1px 3px rgba(0, 0, 0, 0.2);
+ --sk-shadow-hover: 0 4px 12px rgba(0, 0, 0, 0.3);
}
.dark .sk-terminal,
[data-theme="dark"] .sk-terminal {
- border-color: #333;
+ border-color: #333;
}
.dark .sk-cell-link:hover,
[data-theme="dark"] .sk-cell-link:hover {
- background-color: rgba(74, 108, 247, 0.1);
+ background-color: rgba(74, 108, 247, 0.1);
}
.dark tr:nth-child(even) td,
[data-theme="dark"] tr:nth-child(even) td {
- background-color: rgba(28, 25, 23, 0.5) !important;
+ background-color: rgba(28, 25, 23, 0.5) !important;
}
.dark ::-webkit-scrollbar-track,
[data-theme="dark"] ::-webkit-scrollbar-track {
- background: #1C1917;
+ background: #1c1917;
}
-
/* =============================================
HOMEPAGE — Full-width editorial layout
Inspired by farming-labs: typography-first,
@@ -801,400 +854,402 @@ header[class*="header"] {
/* --- Page wrapper — full width with edge padding --- */
.fm-page {
- max-width: 1200px;
- margin: 0 auto;
- padding: 0 48px 80px;
+ max-width: 1200px;
+ margin: 0 auto;
+ padding: 0 48px 80px;
}
/* ---- SIDE TABLE OF CONTENTS ---- */
.fm-toc {
- position: fixed;
- top: 50%;
- left: max(16px, calc(50% - 600px - 200px));
- transform: translateY(-50%);
- display: flex;
- flex-direction: column;
- gap: 4px;
- width: 150px;
- z-index: 10;
+ position: fixed;
+ top: 50%;
+ left: max(16px, calc(50% - 600px - 200px));
+ transform: translateY(-50%);
+ display: flex;
+ flex-direction: column;
+ gap: 4px;
+ width: 150px;
+ z-index: 10;
}
.fm-toc-title {
- font-family: var(--sk-mono);
- font-size: 10px;
- font-weight: 600;
- letter-spacing: 0.1em;
- color: var(--sk-text-muted);
- opacity: 0.5;
- margin-bottom: 8px;
+ font-family: var(--sk-mono);
+ font-size: 10px;
+ font-weight: 600;
+ letter-spacing: 0.1em;
+ color: var(--sk-text-muted);
+ opacity: 0.5;
+ margin-bottom: 8px;
}
.fm-toc-link {
- font-family: var(--sk-mono) !important;
- font-size: 12px !important;
- color: var(--sk-text-muted) !important;
- text-decoration: none !important;
- padding: 5px 0 5px 14px;
- border-left: 1.5px solid transparent;
- transition: color 0.15s ease, border-color 0.15s ease;
- display: block;
+ font-family: var(--sk-mono) !important;
+ font-size: 12px !important;
+ color: var(--sk-text-muted) !important;
+ text-decoration: none !important;
+ padding: 5px 0 5px 14px;
+ border-left: 1.5px solid transparent;
+ transition:
+ color 0.15s ease,
+ border-color 0.15s ease;
+ display: block;
}
.fm-toc-link:hover {
- color: var(--sk-charcoal) !important;
- border-left-color: var(--sk-charcoal);
+ color: var(--sk-charcoal) !important;
+ border-left-color: var(--sk-charcoal);
}
.fm-toc-divider {
- height: 1px;
- background: rgba(0, 0, 0, 0.06);
- margin: 8px 0 8px 14px;
- width: 40px;
+ height: 1px;
+ background: rgba(0, 0, 0, 0.06);
+ margin: 8px 0 8px 14px;
+ width: 40px;
}
.fm-toc-ext {
- font-size: 11px !important;
- opacity: 0.7;
+ font-size: 11px !important;
+ opacity: 0.7;
}
@media (max-width: 1350px) {
- .fm-toc {
- display: none;
- }
+ .fm-toc {
+ display: none;
+ }
}
.dark .fm-toc-divider,
[data-theme="dark"] .fm-toc-divider {
- background: rgba(255, 255, 255, 0.08);
+ background: rgba(255, 255, 255, 0.08);
}
.dark .fm-toc-link:hover,
[data-theme="dark"] .fm-toc-link:hover {
- color: #f1f5f9 !important;
- border-left-color: #f1f5f9;
+ color: #f1f5f9 !important;
+ border-left-color: #f1f5f9;
}
.dark .fm-hero-nav-link:hover,
[data-theme="dark"] .fm-hero-nav-link:hover {
- color: #f1f5f9 !important;
+ color: #f1f5f9 !important;
}
.dark .fm-hero-toc,
[data-theme="dark"] .fm-hero-toc {
- border-color: rgba(255, 255, 255, 0.1);
+ border-color: rgba(255, 255, 255, 0.1);
}
.dark .fm-hero-toc-item,
[data-theme="dark"] .fm-hero-toc-item {
- color: #f1f5f9 !important;
+ color: #f1f5f9 !important;
}
.dark .fm-btn-outline,
[data-theme="dark"] .fm-btn-outline {
- color: #f1f5f9 !important;
- border-color: rgba(255, 255, 255, 0.2);
+ color: #f1f5f9 !important;
+ border-color: rgba(255, 255, 255, 0.2);
}
.dark .fm-btn-outline:hover,
[data-theme="dark"] .fm-btn-outline:hover {
- border-color: rgba(255, 255, 255, 0.5);
+ border-color: rgba(255, 255, 255, 0.5);
}
/* ---- THEME TOGGLE (injected by theme-toggle.js) ---- */
.fm-theme-toggle {
- font-family: var(--sk-mono);
- font-size: 14px;
- cursor: pointer;
- color: var(--sk-text-muted);
- transition: color 0.15s ease;
- line-height: 1;
- user-select: none;
- background: none;
- border: none;
- padding: 0;
- margin: 0;
+ font-family: var(--sk-mono);
+ font-size: 14px;
+ cursor: pointer;
+ color: var(--sk-text-muted);
+ transition: color 0.15s ease;
+ line-height: 1;
+ user-select: none;
+ background: none;
+ border: none;
+ padding: 0;
+ margin: 0;
}
.fm-theme-toggle:hover {
- color: var(--sk-charcoal);
+ color: var(--sk-charcoal);
}
.dark .fm-theme-toggle:hover,
[data-theme="dark"] .fm-theme-toggle:hover {
- color: #f1f5f9;
+ color: #f1f5f9;
}
/* --- Shared mono link style --- */
.fm-mono-link {
- font-family: var(--sk-mono) !important;
- font-size: 12px !important;
- letter-spacing: 0.03em;
- color: var(--sk-text-muted) !important;
- text-decoration: none !important;
- transition: color 0.15s ease;
+ font-family: var(--sk-mono) !important;
+ font-size: 12px !important;
+ letter-spacing: 0.03em;
+ color: var(--sk-text-muted) !important;
+ text-decoration: none !important;
+ transition: color 0.15s ease;
}
.fm-mono-link:hover {
- color: var(--sk-charcoal) !important;
+ color: var(--sk-charcoal) !important;
}
/* ---- HERO ---- */
.fm-hero {
- padding: 80px 0 72px;
- border-bottom: 1px solid rgba(0, 0, 0, 0.08);
- text-align: center;
+ padding: 80px 0 72px;
+ border-bottom: 1px solid rgba(0, 0, 0, 0.08);
+ text-align: center;
}
.fm-hero-meta {
- display: flex;
- align-items: center;
- justify-content: center;
- gap: 10px;
- margin-bottom: 40px;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ gap: 10px;
+ margin-bottom: 40px;
}
.fm-meta-sep {
- font-family: var(--sk-mono);
- font-size: 12px;
- color: rgba(0, 0, 0, 0.15);
+ font-family: var(--sk-mono);
+ font-size: 12px;
+ color: rgba(0, 0, 0, 0.15);
}
.fm-hero-title {
- font-size: 56px;
- font-weight: 700;
- line-height: 0.97;
- letter-spacing: -0.04em;
- color: var(--sk-charcoal);
- margin: 0 0 28px;
+ font-size: 56px;
+ font-weight: 700;
+ line-height: 0.97;
+ letter-spacing: -0.04em;
+ color: var(--sk-charcoal);
+ margin: 0 0 28px;
}
.fm-hero-sub {
- font-size: 18px;
- line-height: 1.7;
- color: var(--sk-text-muted);
- max-width: 620px;
- margin: 0 auto 20px;
+ font-size: 18px;
+ line-height: 1.7;
+ color: var(--sk-text-muted);
+ max-width: 620px;
+ margin: 0 auto 20px;
}
/* --- Hero TOC block --- */
.fm-hero-toc {
- border: 1px solid rgba(0, 0, 0, 0.1);
- border-radius: 2px;
- padding: 16px 24px;
- margin: 0 auto 28px;
- display: inline-block;
+ border: 1px solid rgba(0, 0, 0, 0.1);
+ border-radius: 2px;
+ padding: 16px 24px;
+ margin: 0 auto 28px;
+ display: inline-block;
}
.fm-hero-toc-label {
- display: block;
- font-family: var(--sk-mono);
- font-size: 10px;
- font-weight: 600;
- letter-spacing: 0.12em;
- color: var(--sk-text-muted);
- opacity: 0.5;
- margin-bottom: 10px;
- text-align: center;
+ display: block;
+ font-family: var(--sk-mono);
+ font-size: 10px;
+ font-weight: 600;
+ letter-spacing: 0.12em;
+ color: var(--sk-text-muted);
+ opacity: 0.5;
+ margin-bottom: 10px;
+ text-align: center;
}
.fm-hero-toc-items {
- display: flex;
- justify-content: center;
- gap: 20px;
+ display: flex;
+ justify-content: center;
+ gap: 20px;
}
.fm-hero-toc-item {
- font-family: var(--sk-mono) !important;
- font-size: 12px !important;
- letter-spacing: 0.02em;
- color: var(--sk-charcoal) !important;
- text-decoration: none !important;
- transition: opacity 0.15s ease;
- white-space: nowrap;
+ font-family: var(--sk-mono) !important;
+ font-size: 12px !important;
+ letter-spacing: 0.02em;
+ color: var(--sk-charcoal) !important;
+ text-decoration: none !important;
+ transition: opacity 0.15s ease;
+ white-space: nowrap;
}
.fm-hero-toc-item:hover {
- opacity: 0.6;
+ opacity: 0.6;
}
/* --- Hero nav (secondary links below CTAs) --- */
.fm-hero-nav {
- display: flex;
- align-items: center;
- justify-content: center;
- gap: 12px;
- margin-top: 16px;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ gap: 12px;
+ margin-top: 16px;
}
.fm-hero-nav-link {
- font-family: var(--sk-mono) !important;
- font-size: 12px !important;
- letter-spacing: 0.03em;
- color: var(--sk-text-muted) !important;
- text-decoration: none !important;
- transition: color 0.15s ease;
+ font-family: var(--sk-mono) !important;
+ font-size: 12px !important;
+ letter-spacing: 0.03em;
+ color: var(--sk-text-muted) !important;
+ text-decoration: none !important;
+ transition: color 0.15s ease;
}
.fm-hero-nav-link:hover {
- color: var(--sk-charcoal) !important;
+ color: var(--sk-charcoal) !important;
}
.fm-hero-ctas {
- display: flex;
- align-items: center;
- justify-content: center;
- gap: 20px;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ gap: 20px;
}
.fm-btn-primary {
- display: inline-block;
- font-family: var(--sk-mono) !important;
- font-size: 12px !important;
- font-weight: 600;
- letter-spacing: 0.1em;
- padding: 14px 32px;
- background: var(--sk-charcoal);
- color: #fff !important;
- text-decoration: none !important;
- transition: opacity 0.15s ease;
+ display: inline-block;
+ font-family: var(--sk-mono) !important;
+ font-size: 12px !important;
+ font-weight: 600;
+ letter-spacing: 0.1em;
+ padding: 14px 32px;
+ background: var(--sk-charcoal);
+ color: #fff !important;
+ text-decoration: none !important;
+ transition: opacity 0.15s ease;
}
.fm-btn-primary:hover {
- opacity: 0.8;
+ opacity: 0.8;
}
.fm-btn-outline {
- display: inline-block;
- font-family: var(--sk-mono) !important;
- font-size: 12px !important;
- font-weight: 600;
- letter-spacing: 0.1em;
- padding: 14px 32px;
- background: transparent;
- color: var(--sk-charcoal) !important;
- border: 1px solid rgba(0, 0, 0, 0.2);
- text-decoration: none !important;
- transition: border-color 0.15s ease;
+ display: inline-block;
+ font-family: var(--sk-mono) !important;
+ font-size: 12px !important;
+ font-weight: 600;
+ letter-spacing: 0.1em;
+ padding: 14px 32px;
+ background: transparent;
+ color: var(--sk-charcoal) !important;
+ border: 1px solid rgba(0, 0, 0, 0.2);
+ text-decoration: none !important;
+ transition: border-color 0.15s ease;
}
.fm-btn-outline:hover {
- border-color: rgba(0, 0, 0, 0.5);
+ border-color: rgba(0, 0, 0, 0.5);
}
.fm-btn-ghost {
- font-family: var(--sk-mono) !important;
- font-size: 12px !important;
- font-weight: 500;
- letter-spacing: 0.06em;
- color: var(--sk-text-muted) !important;
- text-decoration: none !important;
- transition: color 0.15s ease;
+ font-family: var(--sk-mono) !important;
+ font-size: 12px !important;
+ font-weight: 500;
+ letter-spacing: 0.06em;
+ color: var(--sk-text-muted) !important;
+ text-decoration: none !important;
+ transition: color 0.15s ease;
}
.fm-btn-ghost:hover {
- color: var(--sk-charcoal) !important;
+ color: var(--sk-charcoal) !important;
}
/* ---- SECTIONS ---- */
.fm-section {
- padding: 72px 0;
- border-bottom: 1px solid rgba(0, 0, 0, 0.08);
+ padding: 72px 0;
+ border-bottom: 1px solid rgba(0, 0, 0, 0.08);
}
.fm-section-last {
- border-bottom: none;
- padding-bottom: 48px;
+ border-bottom: none;
+ padding-bottom: 48px;
}
.fm-section-head {
- margin-bottom: 48px;
+ margin-bottom: 48px;
}
.fm-section-num {
- display: block;
- font-family: var(--sk-mono);
- font-size: 12px;
- font-weight: 500;
- letter-spacing: 0.08em;
- color: var(--sk-text-muted);
- margin-bottom: 12px;
+ display: block;
+ font-family: var(--sk-mono);
+ font-size: 12px;
+ font-weight: 500;
+ letter-spacing: 0.08em;
+ color: var(--sk-text-muted);
+ margin-bottom: 12px;
}
.fm-section-title {
- font-size: 40px;
- font-weight: 700;
- letter-spacing: -0.035em;
- line-height: 1.05;
- color: var(--sk-charcoal);
- margin: 0;
+ font-size: 40px;
+ font-weight: 700;
+ letter-spacing: -0.035em;
+ line-height: 1.05;
+ color: var(--sk-charcoal);
+ margin: 0;
}
.fm-section-sub {
- font-size: 17px;
- color: var(--sk-text-muted);
- margin: 12px 0 0;
+ font-size: 17px;
+ color: var(--sk-text-muted);
+ margin: 12px 0 0;
}
/* ---- TYPOGRAPHY ---- */
.fm-prose {
- font-size: 17px;
- line-height: 1.75;
- color: var(--sk-text-muted);
- margin: 0 0 24px;
+ font-size: 17px;
+ line-height: 1.75;
+ color: var(--sk-text-muted);
+ margin: 0 0 24px;
}
.fm-prose strong {
- color: var(--sk-charcoal);
- font-weight: 600;
+ color: var(--sk-charcoal);
+ font-weight: 600;
}
.fm-h3 {
- font-size: 24px;
- font-weight: 700;
- letter-spacing: -0.02em;
- color: var(--sk-charcoal);
- margin: 0 0 16px;
+ font-size: 24px;
+ font-weight: 700;
+ letter-spacing: -0.02em;
+ color: var(--sk-charcoal);
+ margin: 0 0 16px;
}
/* ---- TWO-COLUMN LAYOUT ---- */
.fm-two-col {
- display: grid;
- grid-template-columns: 1fr 280px;
- gap: 48px;
- align-items: start;
- margin-bottom: 8px;
+ display: grid;
+ grid-template-columns: 1fr 280px;
+ gap: 48px;
+ align-items: start;
+ margin-bottom: 8px;
}
.fm-aside-note {
- font-family: var(--sk-mono);
- font-size: 13px;
- line-height: 1.6;
- color: var(--sk-text-muted);
- border-left: 2px solid rgba(0, 0, 0, 0.08);
- padding-left: 16px;
- margin: 0;
+ font-family: var(--sk-mono);
+ font-size: 13px;
+ line-height: 1.6;
+ color: var(--sk-text-muted);
+ border-left: 2px solid rgba(0, 0, 0, 0.08);
+ padding-left: 16px;
+ margin: 0;
}
/* ---- IMAGES ---- */
.fm-img {
- display: block;
- width: 100%;
- margin: 32px 0;
+ display: block;
+ width: 100%;
+ margin: 32px 0;
}
/* ---- RULE ---- */
.fm-rule {
- height: 1px;
- background: rgba(0, 0, 0, 0.08);
- margin: 56px 0;
+ height: 1px;
+ background: rgba(0, 0, 0, 0.08);
+ margin: 56px 0;
}
/* (steps grid removed — replaced by diagrams) */
@@ -1202,204 +1257,202 @@ header[class*="header"] {
/* ---- CAPABILITIES GRID ---- */
.fm-cap-grid {
- display: grid;
- grid-template-columns: repeat(3, 1fr);
- gap: 0;
- border-top: 1px solid rgba(0, 0, 0, 0.08);
- margin-top: 8px;
+ display: grid;
+ grid-template-columns: repeat(3, 1fr);
+ gap: 0;
+ border-top: 1px solid rgba(0, 0, 0, 0.08);
+ margin-top: 8px;
}
.fm-cap-cell {
- padding: 28px 24px;
- border-bottom: 1px solid rgba(0, 0, 0, 0.08);
- border-right: 1px solid rgba(0, 0, 0, 0.08);
+ padding: 28px 24px;
+ border-bottom: 1px solid rgba(0, 0, 0, 0.08);
+ border-right: 1px solid rgba(0, 0, 0, 0.08);
}
.fm-cap-cell:nth-child(3n) {
- border-right: none;
+ border-right: none;
}
.fm-cap-wide {
- grid-column: 1 / -1;
- border-right: none;
+ grid-column: 1 / -1;
+ border-right: none;
}
.fm-cap-name {
- font-size: 14px;
- font-weight: 600;
- color: var(--sk-charcoal);
- margin: 0 0 6px;
+ font-size: 14px;
+ font-weight: 600;
+ color: var(--sk-charcoal);
+ margin: 0 0 6px;
}
.fm-cap-desc {
- font-size: 14px;
- line-height: 1.6;
- color: var(--sk-text-muted);
- margin: 0;
+ font-size: 14px;
+ line-height: 1.6;
+ color: var(--sk-text-muted);
+ margin: 0;
}
.fm-cap-desc code {
- font-family: var(--sk-mono);
- font-size: 12px;
- color: var(--sk-text-muted);
+ font-family: var(--sk-mono);
+ font-size: 12px;
+ color: var(--sk-text-muted);
}
/* ---- PATH GRID ---- */
.fm-path-grid {
- display: grid;
- grid-template-columns: 1fr 1fr;
- gap: 0;
- border: 1px solid rgba(0, 0, 0, 0.08);
- margin-top: 8px;
+ display: grid;
+ grid-template-columns: 1fr 1fr;
+ gap: 0;
+ border: 1px solid rgba(0, 0, 0, 0.08);
+ margin-top: 8px;
}
.fm-path-card {
- display: block;
- padding: 32px 28px;
- text-decoration: none !important;
- color: inherit !important;
- border-right: 1px solid rgba(0, 0, 0, 0.08);
- border-bottom: 1px solid rgba(0, 0, 0, 0.08);
- transition: background-color 0.15s ease;
+ display: block;
+ padding: 32px 28px;
+ text-decoration: none !important;
+ color: inherit !important;
+ border-right: 1px solid rgba(0, 0, 0, 0.08);
+ border-bottom: 1px solid rgba(0, 0, 0, 0.08);
+ transition: background-color 0.15s ease;
}
.fm-path-card:nth-child(2n) {
- border-right: none;
+ border-right: none;
}
-.fm-path-card:nth-child(n+3) {
- border-bottom: none;
+.fm-path-card:nth-child(n + 3) {
+ border-bottom: none;
}
.fm-path-card:hover {
- background-color: rgba(0, 0, 0, 0.02);
+ background-color: rgba(0, 0, 0, 0.02);
}
.fm-path-label {
- display: block;
- font-family: var(--sk-mono);
- font-size: 11px;
- font-weight: 500;
- letter-spacing: 0.1em;
- color: var(--sk-text-muted);
- margin-bottom: 10px;
+ display: block;
+ font-family: var(--sk-mono);
+ font-size: 11px;
+ font-weight: 500;
+ letter-spacing: 0.1em;
+ color: var(--sk-text-muted);
+ margin-bottom: 10px;
}
.fm-path-name {
- display: block;
- font-size: 17px;
- font-weight: 600;
- color: var(--sk-charcoal);
- margin-bottom: 8px;
+ display: block;
+ font-size: 17px;
+ font-weight: 600;
+ color: var(--sk-charcoal);
+ margin-bottom: 8px;
}
.fm-path-desc {
- font-size: 14px;
- line-height: 1.6;
- color: var(--sk-text-muted);
- margin: 0;
+ font-size: 14px;
+ line-height: 1.6;
+ color: var(--sk-text-muted);
+ margin: 0;
}
/* ---- FOOTER ---- */
.fm-footer {
- display: flex;
- align-items: center;
- justify-content: space-between;
- padding: 28px 0 0;
- margin-top: 8px;
- border-top: 1px solid rgba(0, 0, 0, 0.08);
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ padding: 28px 0 0;
+ margin-top: 8px;
+ border-top: 1px solid rgba(0, 0, 0, 0.08);
}
.fm-footer-right {
- display: flex;
- gap: 20px;
+ display: flex;
+ gap: 20px;
}
-
/* ---- DIAGRAMS ---- */
.fm-diagram {
- margin: 40px 0;
+ margin: 40px 0;
}
.fm-dia-row {
- display: flex;
- align-items: stretch;
+ display: flex;
+ align-items: stretch;
}
.fm-dia-row-3 .fm-dia-card {
- flex: 1;
+ flex: 1;
}
.fm-dia-card {
- flex: 1;
- padding: 24px 20px;
- background: #fff;
- border: 1px solid rgba(0, 0, 0, 0.08);
+ flex: 1;
+ padding: 24px 20px;
+ background: #fff;
+ border: 1px solid rgba(0, 0, 0, 0.08);
}
.fm-dia-card-lg {
- padding: 28px 24px;
+ padding: 28px 24px;
}
.fm-dia-arrow {
- display: flex;
- align-items: center;
- justify-content: center;
- width: 36px;
- flex-shrink: 0;
- font-size: 18px;
- color: rgba(0, 0, 0, 0.18);
- font-family: var(--sk-mono);
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ width: 36px;
+ flex-shrink: 0;
+ font-size: 18px;
+ color: rgba(0, 0, 0, 0.18);
+ font-family: var(--sk-mono);
}
.fm-dia-num {
- display: block;
- font-family: var(--sk-mono);
- font-size: 28px;
- font-weight: 700;
- color: rgba(0, 0, 0, 0.35);
- line-height: 1;
- margin-bottom: 14px;
+ display: block;
+ font-family: var(--sk-mono);
+ font-size: 28px;
+ font-weight: 700;
+ color: rgba(0, 0, 0, 0.35);
+ line-height: 1;
+ margin-bottom: 14px;
}
.fm-dia-label {
- display: block;
- font-family: var(--sk-mono);
- font-size: 12px;
- font-weight: 600;
- letter-spacing: 0.08em;
- color: var(--sk-charcoal);
- margin-bottom: 8px;
+ display: block;
+ font-family: var(--sk-mono);
+ font-size: 12px;
+ font-weight: 600;
+ letter-spacing: 0.08em;
+ color: var(--sk-charcoal);
+ margin-bottom: 8px;
}
.fm-dia-desc {
- font-size: 14px;
- line-height: 1.6;
- color: var(--sk-text-muted);
- margin: 0;
+ font-size: 14px;
+ line-height: 1.6;
+ color: var(--sk-text-muted);
+ margin: 0;
}
.fm-dia-return {
- margin: 0 20px;
- border-left: 1px dashed rgba(0, 0, 0, 0.1);
- border-bottom: 1px dashed rgba(0, 0, 0, 0.1);
- border-right: 1px dashed rgba(0, 0, 0, 0.1);
- border-radius: 0 0 4px 4px;
- padding: 14px 0;
- text-align: center;
+ margin: 0 20px;
+ border-left: 1px dashed rgba(0, 0, 0, 0.1);
+ border-bottom: 1px dashed rgba(0, 0, 0, 0.1);
+ border-right: 1px dashed rgba(0, 0, 0, 0.1);
+ border-radius: 0 0 4px 4px;
+ padding: 14px 0;
+ text-align: center;
}
.fm-dia-return span {
- font-family: var(--sk-mono);
- font-size: 12px;
- letter-spacing: 0.04em;
- color: var(--sk-text-muted);
+ font-family: var(--sk-mono);
+ font-size: 12px;
+ letter-spacing: 0.04em;
+ color: var(--sk-text-muted);
}
-
/* ---- DARK MODE ---- */
.dark .fm-hero,
@@ -1410,191 +1463,190 @@ header[class*="header"] {
[data-theme="dark"] .fm-rule,
.dark .fm-footer,
[data-theme="dark"] .fm-footer {
- border-color: rgba(255, 255, 255, 0.08);
+ border-color: rgba(255, 255, 255, 0.08);
}
.dark .fm-meta-sep,
[data-theme="dark"] .fm-meta-sep {
- color: rgba(255, 255, 255, 0.15);
+ color: rgba(255, 255, 255, 0.15);
}
.dark .fm-btn-primary,
[data-theme="dark"] .fm-btn-primary {
- background: #f5f0eb;
- color: #1C1917 !important;
+ background: #f5f0eb;
+ color: #1c1917 !important;
}
.dark .fm-cap-cell,
[data-theme="dark"] .fm-cap-cell {
- border-color: rgba(255, 255, 255, 0.08);
+ border-color: rgba(255, 255, 255, 0.08);
}
.dark .fm-cap-grid,
[data-theme="dark"] .fm-cap-grid {
- border-color: rgba(255, 255, 255, 0.08);
+ border-color: rgba(255, 255, 255, 0.08);
}
.dark .fm-path-grid,
[data-theme="dark"] .fm-path-grid {
- border-color: rgba(255, 255, 255, 0.08);
+ border-color: rgba(255, 255, 255, 0.08);
}
.dark .fm-path-card,
[data-theme="dark"] .fm-path-card {
- border-color: rgba(255, 255, 255, 0.08);
+ border-color: rgba(255, 255, 255, 0.08);
}
.dark .fm-path-card:hover,
[data-theme="dark"] .fm-path-card:hover {
- background-color: rgba(255, 255, 255, 0.03);
+ background-color: rgba(255, 255, 255, 0.03);
}
.dark .fm-aside-note,
[data-theme="dark"] .fm-aside-note {
- border-color: rgba(255, 255, 255, 0.08);
+ border-color: rgba(255, 255, 255, 0.08);
}
.dark .fm-dia-card,
[data-theme="dark"] .fm-dia-card {
- background: rgba(255, 255, 255, 0.04);
- border-color: rgba(255, 255, 255, 0.08);
+ background: rgba(255, 255, 255, 0.04);
+ border-color: rgba(255, 255, 255, 0.08);
}
.dark .fm-dia-num,
[data-theme="dark"] .fm-dia-num {
- color: rgba(255, 255, 255, 0.4);
+ color: rgba(255, 255, 255, 0.4);
}
.dark .fm-dia-label,
[data-theme="dark"] .fm-dia-label {
- color: #e2e8f0;
+ color: #e2e8f0;
}
.dark .fm-dia-desc,
[data-theme="dark"] .fm-dia-desc {
- color: rgba(255, 255, 255, 0.5);
+ color: rgba(255, 255, 255, 0.5);
}
.dark .fm-dia-arrow,
[data-theme="dark"] .fm-dia-arrow {
- color: rgba(255, 255, 255, 0.18);
+ color: rgba(255, 255, 255, 0.18);
}
.dark .fm-dia-return,
[data-theme="dark"] .fm-dia-return {
- border-color: rgba(255, 255, 255, 0.1);
+ border-color: rgba(255, 255, 255, 0.1);
}
.dark .fm-prose strong,
[data-theme="dark"] .fm-prose strong {
- color: #f1f5f9;
+ color: #f1f5f9;
}
.dark .fm-mono-link:hover,
[data-theme="dark"] .fm-mono-link:hover {
- color: #f1f5f9 !important;
+ color: #f1f5f9 !important;
}
-
/* ---- RESPONSIVE ---- */
@media (max-width: 900px) {
- .fm-page {
- padding: 0 28px 60px;
- }
+ .fm-page {
+ padding: 0 28px 60px;
+ }
- .fm-hero-title {
- font-size: 40px;
- }
+ .fm-hero-title {
+ font-size: 40px;
+ }
- .fm-section-title {
- font-size: 32px;
- }
+ .fm-section-title {
+ font-size: 32px;
+ }
- .fm-two-col {
- grid-template-columns: 1fr;
- gap: 20px;
- }
+ .fm-two-col {
+ grid-template-columns: 1fr;
+ gap: 20px;
+ }
- .fm-dia-row {
- flex-direction: column;
- }
+ .fm-dia-row {
+ flex-direction: column;
+ }
- .fm-dia-arrow {
- width: auto;
- height: 28px;
- font-size: 16px;
- transform: rotate(90deg);
- }
+ .fm-dia-arrow {
+ width: auto;
+ height: 28px;
+ font-size: 16px;
+ transform: rotate(90deg);
+ }
- .fm-dia-return {
- margin: 0 12px;
- }
+ .fm-dia-return {
+ margin: 0 12px;
+ }
- .fm-cap-grid {
- grid-template-columns: 1fr;
- }
+ .fm-cap-grid {
+ grid-template-columns: 1fr;
+ }
- .fm-cap-cell {
- border-right: none;
- }
+ .fm-cap-cell {
+ border-right: none;
+ }
- .fm-path-grid {
- grid-template-columns: 1fr;
- }
+ .fm-path-grid {
+ grid-template-columns: 1fr;
+ }
- .fm-path-card {
- border-right: none;
- }
+ .fm-path-card {
+ border-right: none;
+ }
- .fm-path-card:nth-child(n+3) {
- border-bottom: 1px solid rgba(0, 0, 0, 0.08);
- }
+ .fm-path-card:nth-child(n + 3) {
+ border-bottom: 1px solid rgba(0, 0, 0, 0.08);
+ }
- .fm-path-card:last-child {
- border-bottom: none;
- }
+ .fm-path-card:last-child {
+ border-bottom: none;
+ }
}
@media (max-width: 600px) {
- .fm-page {
- padding: 0 20px 48px;
- }
-
- .fm-hero {
- padding: 48px 0 40px;
- }
-
- .fm-hero-title {
- font-size: 32px;
- }
-
- .fm-hero-ctas {
- flex-direction: column;
- align-items: center;
- gap: 12px;
- }
-
- .fm-hero-nav {
- flex-wrap: wrap;
- gap: 8px;
- }
-
- .fm-section {
- padding: 48px 0;
- }
-
- .fm-section-title {
- font-size: 26px;
- }
-
- .fm-footer {
- flex-direction: column;
- gap: 16px;
- text-align: center;
- }
-
- .fm-footer-right {
- justify-content: center;
- }
+ .fm-page {
+ padding: 0 20px 48px;
+ }
+
+ .fm-hero {
+ padding: 48px 0 40px;
+ }
+
+ .fm-hero-title {
+ font-size: 32px;
+ }
+
+ .fm-hero-ctas {
+ flex-direction: column;
+ align-items: center;
+ gap: 12px;
+ }
+
+ .fm-hero-nav {
+ flex-wrap: wrap;
+ gap: 8px;
+ }
+
+ .fm-section {
+ padding: 48px 0;
+ }
+
+ .fm-section-title {
+ font-size: 26px;
+ }
+
+ .fm-footer {
+ flex-direction: column;
+ gap: 16px;
+ text-align: center;
+ }
+
+ .fm-footer-right {
+ justify-content: center;
+ }
}