# Custom Subdomains (Proxy)
Source: https://docs.arminterview.my/custom-subdomains

How to use your own subdomain instead of arminterview.my

# Custom Subdomains via Proxy

By default, your company's job board is accessible at `arminterview.my/companies/your-company-slug`. However, you can use your own custom subdomain (e.g., `careers.yourcompany.com`) to provide a more professional, branded experience for your candidates.

## Benefits of Custom Subdomains

* **Brand Trust**: Candidates feel more secure applying on a domain they recognize.
* **Unified Experience**: Seamlessly integrate your job board into your main website navigation.
* **Improved SEO**: Leverage your main domain's authority for your recruitment landing pages.

## Setup Instructions

To use your own subdomain, you need to set up a reverse proxy or point your DNS to our servers.

### 1. DNS Configuration (CNAME)

The simplest way to set up a custom subdomain is via a CNAME record. This allows us to handle SSL and routing automatically.

| Type  | Host      | Value             |
| ----- | --------- | ----------------- |
| CNAME | `careers` | `arminterview.my` |

> \[!NOTE]
> After adding the CNAME record, it may take up to 24 hours for DNS changes to propagate globally.

### 2. Reverse Proxy Configuration

If you prefer to maintain full control over the traffic or are integrating into an existing application, you can use a reverse proxy.

#### Example: Nginx

Use this configuration if you are running your own web server.

```nginx theme={null}
server {
    listen 80;
    server_name careers.yourcompany.com;

    location / {
        proxy_pass https://arminterview.my/companies/your-company-slug;
        proxy_set_header Host arminterview.my;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_ssl_server_name on;
    }
}
```

#### Example: Next.js Rewrites

If you have an existing Next.js application, you can proxy the traffic using the built-in rewrite engine.

```javascript theme={null}
// next.config.js
module.exports = {
  async rewrites() {
    return [
      {
        source: '/careers/:path*',
        destination: 'https://arminterview.my/companies/your-company-slug/:path*',
      },
    ]
  },
}
```

## Troubleshooting & FAQ

<AccordionGroup>
  <Accordion title="Does ArmInterview provide SSL for custom domains?">
    Yes. If you use the CNAME method, we automatically provision and renew Let's Encrypt SSL certificates for your subdomain.
  </Accordion>

  <Accordion title="I'm getting a 404 error after setup.">
    Ensure that your **Custom Slug (URL)** in the Dashboard match exactly with the `your-company-slug` used in your proxy settings.
  </Accordion>

  <Accordion title="Can I use a root domain instead of a subdomain?">
    We recommend using a subdomain (like `careers.`) as root domains (A records) require static IP addresses which may change. CNAMEs are much more reliable.
  </Accordion>
</AccordionGroup>

> \[!IMPORTANT]
> Always verify that your proxy passes the `Host` header correctly as `arminterview.my`, otherwise our routing engine will not be able to identify the incoming request.


# Embed Job Listings
Source: https://docs.arminterview.my/embed-code

Learn how to embed your open positions on your own website

# Embedding Job Listings

Displaying your open positions directly on your company website is a great way to maintain brand consistency and keep candidates on your platform. ArmInterview's embed widget is designed to be lightweight, responsive, and easy to integrate.

## Getting the Embed Code

1. Log in to your [ArmInterview Dashboard](https://arminterview.my/dashboard/company).
2. Navigate to the **Company Branding** section.
3. Locate the **Embed Job Listings** section.
4. Copy the provided `<iframe>` code snippet.

## Standard Implementation

The basic embed code provides a seamless experience for most websites:

```html theme={null}
<iframe 
  src="https://arminterview.my/embed/your-company-slug" 
  width="100%" 
  height="600px" 
  style="border:none; border-radius:12px; overflow:hidden;" 
  title="Company Jobs"
></iframe>
```

### Configuration Options

| Attribute   | Description                                                                                 | Default |
| ----------- | ------------------------------------------------------------------------------------------- | ------- |
| `src`       | The unique URL for your company. Ensure `your-company-slug` matches your dashboard setting. | N/A     |
| `width`     | Responsive width. We recommend `100%` to fit any container.                                 | `100%`  |
| `height`    | The height of the widget. Adjust based on the number of active jobs.                        | `600px` |
| `scrolling` | Enable or disable the internal scrollbar. Recommend `no` if height is sufficient.           | `no`    |

## Advanced Customization

### Responsive Wrapper

To ensure the widget maintains a perfect aspect ratio or handles mobile devices more effectively, you can wrap the iframe in a container:

```html theme={null}
<div class="jobs-embed-container" style="position: relative; overflow: hidden; width: 100%; padding-top: 56.25%;">
  <iframe 
    src="https://arminterview.my/embed/your-company-slug" 
    style="position: absolute; top: 0; left: 0; bottom: 0; right: 0; width: 100%; height: 100%; border: none;"
    allowfullscreen>
  </iframe>
</div>
```

### Visual Identity

The embedded widget automatically inherits the visual settings defined in your dashboard:

* **Primary Color**: Used for buttons and key interaction elements.
* **Surface Color**: Used for backgrounds (White/Dark mode compatible).
* **Typography**: Inherits our clean, professional font family for readability.

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Does the widget support Dark Mode?">
    Yes! The widget automatically detects the user's browser theme preference or inherits the theme settings from your main ArmInterview dashboard configuration.
  </Accordion>

  <Accordion title="Can I filter jobs by department?">
    Currently, the embed shows all active public job listings. We are working on adding query parameters to filter by department or location.
  </Accordion>

  <Accordion title="Will it slow down my website?">
    No. The widget is optimized for performance, using lazy loading for assets to ensure your main page content loads first.
  </Accordion>
</AccordionGroup>

> \[!TIP]
> Always use `https://` in the `src` URL to ensure security and prevent mixed-content warnings on your site.


# Introduction
Source: https://docs.arminterview.my/index

Welcome to the ArmInterview documentation

# Welcome to ArmInterview

ArmInterview is a premium, AI-driven recruitment platform designed to transform how companies evaluate talent. By leveraging advanced voice analysis and automated interviewing, we help teams find the right candidates faster while maintaining the highest standard of candidate experience.

## Core Capabilities

<CardGroup>
  <Card title="AI Voice Interviews" icon="microphone">
    Conduct automated screening calls that feel natural and engaging for recruitment.
  </Card>

  <Card title="Candidate Intelligence" icon="brain">
    Deep insights into soft skills, technical proficiency, and cultural fit.
  </Card>

  <Card title="IT Professional Growth" icon="user-tie">
    Helping IT experts master **Soft Skills** and **Salary Negotiation** to level up their careers.
  </Card>

  <Card title="Multi-lingual Support" icon="language">
    Evaluate candidates and practice interviews globally with support for multiple languages.
  </Card>
</CardGroup>

## Why ArmInterview?

In today's competitive job market, speed and precision are everything. ArmInterview eliminates the bottleneck of manual initial screenings, allowing recruiters to:

* **Reduce Time-to-Hire**: Cut screening time by up to 70% with automated first-round interviews.
* **Ensure Fairness**: Use consistent, objective AI evaluation criteria for every candidate.
* **Scale Effortlessly**: Handle hundreds of applicants simultaneously without increasing headcount.

## Get Started with Integration

Whether you want to keep candidates on your site or host a dedicated portal, we offer flexible integration options.

<CardGroup>
  <Card title="Embed Job Listings" icon="code" href="/embed-code">
    Display your open positions directly on your website via a responsive iframe.
  </Card>

  <Card title="Custom Subdomains" icon="globe" href="/custom-subdomains">
    Host your entire recruitment portal on your own branded domain or subdomain.
  </Card>
</CardGroup>

## Need Support?

If you have questions about integration or need technical assistance, our team is here to help. Reach out to us at [grind.softcompany@gmail.com](mailto:grind.softcompany@gmail.com).