> ## Documentation Index
> Fetch the complete documentation index at: https://docs.westyx.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Onboarding

> Set up your organisation and connect your first service - step by step.

<img src="https://mintcdn.com/westyx/kCc7HwRSrGsi_krW/images/onb-welcome.png?fit=max&auto=format&n=kCc7HwRSrGsi_krW&q=85&s=9ba389f167f9804d1b0b9e3584f3e545" alt="Welcome screen" style={{ borderRadius: '12px', marginBottom: '2rem' }} width="1200" height="840" data-path="images/onb-welcome.png" />

<Steps>
  <Step title="Create your account">
    Sign up at [nexus.westyx.dev](https://nexus.westyx.dev) with your work email or an existing identity provider.
  </Step>

  <Step title="Set up your tenant">
    After signing in, you will be prompted to create your tenant. This is your top-level billing and access boundary.

    <img src="https://mintcdn.com/westyx/kCc7HwRSrGsi_krW/images/onb-tenant.png?fit=max&auto=format&n=kCc7HwRSrGsi_krW&q=85&s=46f7c82c19b1c84929f75c7e1ba1f667" alt="Create tenant step" style={{ borderRadius: '8px', margin: '1rem 0' }} width="1200" height="840" data-path="images/onb-tenant.png" />

    Provide the following:

    | Field               | Description                                               |
    | ------------------- | --------------------------------------------------------- |
    | **Name**            | Company, agency, or your own name if you're an individual |
    | **Billing email**   | Invoices and payment notices go here                      |
    | **Billing address** | Required for invoice generation                           |
    | **Tax ID**          | Optional - include your VAT number if applicable          |

    <Note>
      Nexus is built for teams but works equally well for individuals and freelancers managing their own projects.
    </Note>
  </Step>

  <Step title="Create your first project">
    A project represents a single application or product - with its own services, environments, and member list.

    <img src="https://mintcdn.com/westyx/kCc7HwRSrGsi_krW/images/onb-project.png?fit=max&auto=format&n=kCc7HwRSrGsi_krW&q=85&s=e5f5104184765d52f8f94a413a2e634c" alt="Create first project step" style={{ borderRadius: '8px', margin: '1rem 0' }} width="1200" height="840" data-path="images/onb-project.png" />

    Choose a **tier** that matches your needs:

    | Tier             | Environments                   | Notes                     |
    | ---------------- | ------------------------------ | ------------------------- |
    | `free`           | develop only                   | Great for getting started |
    | `xs`             | develop + production           | First paid tier           |
    | `s`              | develop + staging + production | Adds staging              |
    | `m` / `l` / `xl` | All environments               | Full scale                |

    You can upgrade the tier at any time from Project Settings.

    <img src="https://mintcdn.com/westyx/kCc7HwRSrGsi_krW/images/onb-done.png?fit=max&auto=format&n=kCc7HwRSrGsi_krW&q=85&s=c6c966996feed1fddc64d5e028523011" alt="All set screen" style={{ borderRadius: '8px', margin: '1rem 0' }} width="1200" height="840" data-path="images/onb-done.png" />
  </Step>

  <Step title="Create a service">
    Within your project, create a **service** for each deployable unit - a backend API, a frontend app, a worker, etc.

    Every service has a **kind**:

    * **Backend** - uses secret keys; can hold secrets, configs, and flags
    * **Frontend** - uses public keys (safe to expose in the browser); configs and flags only (no secrets in the browser)

    The service kind is immutable after creation.
  </Step>

  <Step title="Add your first secrets and configs">
    Navigate to the **Secrets** or **Configs** tab on your service detail page.

    * Secrets are encrypted at rest with AES-256-GCM and never appear in logs
    * Configs support types: `string`, `number`, `boolean`, `json`
    * Configs can reference secrets by key: `{{secret:DB_PASSWORD}}`
  </Step>

  <Step title="Generate an API key">
    Go to **API Keys** on your service and generate a key.

    Copy it - it is shown only once. Store it in your deployment environment as `NEXUS_API_KEY` or equivalent.
  </Step>

  <Step title="Install the SDK and connect">
    Install the SDK for your language and initialise the client with your service endpoint and API key.

    See the [Quickstart](/quickstart) for language-specific code samples, or browse the full [SDK reference](/sdks/overview).
  </Step>
</Steps>