diff --git a/packages/runtime/README.md b/packages/runtime/README.md
index cb2af80e..b0423bda 100644
--- a/packages/runtime/README.md
+++ b/packages/runtime/README.md
@@ -10,6 +10,7 @@ Watch and compile code with mock diagnostics and html without vite-plugin-checke
 
 ```sh
 pnpm dev-local
+pnpm preview
 ```
 
 ### with vite-plugin-checker
diff --git a/packages/runtime/src/App.svelte b/packages/runtime/src/App.svelte
index d500b2a6..2caa6fd2 100644
--- a/packages/runtime/src/App.svelte
+++ b/packages/runtime/src/App.svelte
@@ -1,18 +1,20 @@
 <script>
   import List from './components/List.svelte'
   import Badge from './components/Badge.svelte'
-  let collapsed = false
+  export let overlayConfig = {}
+  export let initialIsOpen = true
+  export let checkerResults
+
+  let collapsed = !initialIsOpen
   const toggle = () => {
     collapsed = !collapsed
   }
-
-  export let checkerResults
 </script>
 
-<Badge {checkerResults} {collapsed} onClick={toggle} />
+<Badge {checkerResults} {collapsed} position={overlayConfig.position} onClick={toggle} />
 <main class={`window ${collapsed ? 'window-collapsed' : ''}`} on:click|stopPropagation>
   <div class="list-scroll">
-    <List {checkerResults} ulStyle="margin-bottom: 48px;" />
+    <List {checkerResults} ulStyle="margin-bottom: 36px;" />
   </div>
 </main>
 
diff --git a/packages/runtime/src/components/Badge.svelte b/packages/runtime/src/components/Badge.svelte
index d14efac8..9247929f 100644
--- a/packages/runtime/src/components/Badge.svelte
+++ b/packages/runtime/src/components/Badge.svelte
@@ -2,6 +2,7 @@
   export let collapsed
   export let checkerResults
   export let onClick
+  export let position = 'bl'
 
   function calcSummary(results) {
     let errorCount = 0
@@ -28,7 +29,9 @@
 </script>
 
 <button
-  class={`badge-button ${collapsed ? `to-uncollpase ${bgColorClass}` : 'to-collpase'}`}
+  class={`badge-base ${
+    collapsed ? `to-uncollpase ${bgColorClass}` : 'to-collpase'
+  } badge-${position}`}
   on:click|stopPropagation={onClick}
 >
   {#if collapsed}
@@ -42,7 +45,7 @@
 </button>
 
 <style>
-  .badge-button {
+  .badge-base {
     appearance: none;
     font-size: 0.9em;
     font-weight: bold;
@@ -53,10 +56,28 @@
     position: fixed;
     z-index: 99999;
     margin: 0.5em;
+  }
+
+  .badge-bl {
+    bottom: 0px;
+    left: 0px;
+  }
+
+  .badge-br {
     bottom: 0px;
+    right: 0px;
+  }
+
+  .badge-tl {
+    top: 0px;
     left: 0px;
   }
 
+  .badge-tr {
+    top: 0px;
+    right: 0px;
+  }
+
   .to-collpase {
     color: white;
     background: rgb(63, 78, 96);
diff --git a/packages/runtime/src/main.js b/packages/runtime/src/main.js
index 3572738a..81884fef 100644
--- a/packages/runtime/src/main.js
+++ b/packages/runtime/src/main.js
@@ -2,11 +2,17 @@
 import App from './App.svelte'
 
 let enableOverlay = true
-import { prepareListen, listenToCustomMessage, listenToReconnectMessage } from './ws'
+import {
+  prepareListen,
+  listenToCustomMessage,
+  listenToReconnectMessage,
+  listenToConfigMessage,
+} from './ws'
 
 let overlayEle = null
 let app = null
 let checkerResultsStore = []
+let overlayConfig = {}
 
 class ErrorOverlay extends HTMLElement {
   constructor() {
@@ -54,6 +60,7 @@ function updateErrorOverlay(payloads) {
       target: overlayEle.root,
       props: {
         checkerResults: checkerResultsStore,
+        overlayConfig,
       },
     })
   } else {
@@ -69,6 +76,10 @@ function resumeErrorOverlay(data) {
   updateErrorOverlay(payloadsToResume)
 }
 
+function configOverlay(data) {
+  overlayConfig = data
+}
+
 function clearErrorOverlay() {
   document.querySelectorAll(overlayId).forEach((n) => n.close())
   overlayEle = null
@@ -79,5 +90,6 @@ export function inject() {
   const ws = prepareListen()
   listenToCustomMessage(updateErrorOverlay)
   listenToReconnectMessage(resumeErrorOverlay)
+  listenToConfigMessage(configOverlay)
   ws.start()
 }
diff --git a/packages/runtime/src/ws.js b/packages/runtime/src/ws.js
index e0fc5e09..3d4bd1be 100644
--- a/packages/runtime/src/ws.js
+++ b/packages/runtime/src/ws.js
@@ -2,11 +2,20 @@ const socketProtocol = null || (location.protocol === 'https:' ? 'wss' : 'ws')
 const socketHost = `${location.hostname}:${location.port}`
 const socket = new WebSocket(`${socketProtocol}://${socketHost}`, 'vite-hmr')
 
+// #region
+// NOTE: sync modification with packages/vite-plugin-checker/client/index.ts
 const WS_CHECKER_ERROR_EVENT = 'vite-plugin-checker:error'
 const WS_CHECKER_RECONNECT_EVENT = 'vite-plugin-checker:reconnect'
+const WS_CHECKER_CONFIG_RUNTIME_EVENT = 'vite-plugin-checker:config-runtime'
+// #endregion
 
 const onCustomMessage = []
 const onReconnectMessage = []
+const onConfigMessage = []
+
+export function listenToConfigMessage(cb) {
+  onConfigMessage.push(cb)
+}
 
 export function listenToCustomMessage(cb) {
   onCustomMessage.push(cb)
@@ -24,19 +33,19 @@ export function prepareListen() {
         break
       case 'full-reload':
         break
-      default:
-        break
     }
 
     if (data.type === 'custom') {
-      if (data.event === WS_CHECKER_ERROR_EVENT) {
-        // updateErrorOverlay(data.data)
-        onCustomMessage.forEach((callbackfn) => callbackfn(data.data))
-      }
-
-      if (data.event === WS_CHECKER_RECONNECT_EVENT) {
-        onReconnectMessage.forEach((callbackfn) => callbackfn(data.data))
-        // resumeErrorOverlay(data.data)
+      switch (data.event) {
+        case WS_CHECKER_ERROR_EVENT:
+          onCustomMessage.forEach((callbackfn) => callbackfn(data.data))
+          break
+        case WS_CHECKER_RECONNECT_EVENT:
+          onReconnectMessage.forEach((callbackfn) => callbackfn(data.data))
+          break
+        case WS_CHECKER_CONFIG_RUNTIME_EVENT:
+          onConfigMessage.forEach((callbackfn) => callbackfn(data.data))
+          break
       }
     }
   }
diff --git a/packages/vite-plugin-checker/src/client/index.ts b/packages/vite-plugin-checker/src/client/index.ts
index 7fdb10ed..4369a4d6 100644
--- a/packages/vite-plugin-checker/src/client/index.ts
+++ b/packages/vite-plugin-checker/src/client/index.ts
@@ -1,10 +1,12 @@
 import fs from 'fs'
 
-const RUNTIME_PUBLIC_PATH = '/@vite-plugin-checker-runtime'
-const RUNTIME_FILE_PATH = require.resolve('../@runtime/main.js')
-const WS_CHECKER_ERROR_EVENT = 'vite-plugin-checker:error'
-const WS_CHECKER_RECONNECT_EVENT = 'vite-plugin-checker:reconnect'
+// #region
+// NOTE: sync modification with packages/runtime/src/ws.js
+export const RUNTIME_PUBLIC_PATH = '/@vite-plugin-checker-runtime'
+export const RUNTIME_FILE_PATH = require.resolve('../@runtime/main.js')
+export const WS_CHECKER_ERROR_EVENT = 'vite-plugin-checker:error'
+export const WS_CHECKER_RECONNECT_EVENT = 'vite-plugin-checker:reconnect'
+export const WS_CHECKER_CONFIG_RUNTIME_EVENT = 'vite-plugin-checker:config-runtime'
+// #endregion
 
-const runtimeCode = `${fs.readFileSync(RUNTIME_FILE_PATH, 'utf-8')};`
-
-export { runtimeCode, RUNTIME_PUBLIC_PATH, WS_CHECKER_ERROR_EVENT, WS_CHECKER_RECONNECT_EVENT }
+export const runtimeCode = `${fs.readFileSync(RUNTIME_FILE_PATH, 'utf-8')};`
diff --git a/packages/vite-plugin-checker/src/main.ts b/packages/vite-plugin-checker/src/main.ts
index dc851b77..80d3bfad 100644
--- a/packages/vite-plugin-checker/src/main.ts
+++ b/packages/vite-plugin-checker/src/main.ts
@@ -4,7 +4,12 @@ import npmRunPath from 'npm-run-path'
 import { ConfigEnv, Plugin } from 'vite'
 
 import { Checker } from './Checker'
-import { RUNTIME_PUBLIC_PATH, runtimeCode, WS_CHECKER_RECONNECT_EVENT } from './client/index'
+import {
+  RUNTIME_PUBLIC_PATH,
+  runtimeCode,
+  WS_CHECKER_RECONNECT_EVENT,
+  WS_CHECKER_CONFIG_RUNTIME_EVENT,
+} from './client/index'
 import {
   ACTION_TYPES,
   BuildCheckBinStr,
@@ -42,7 +47,8 @@ function createCheckers(userConfig: UserPluginConfig, env: ConfigEnv): ServeAndB
 
 export default function Plugin(userConfig: UserPluginConfig): Plugin {
   const enableBuild = userConfig?.enableBuild ?? true
-  const enableOverlay = userConfig?.overlay ?? true
+  const enableOverlay = userConfig?.overlay !== false
+  const overlayConfig = typeof userConfig?.overlay === 'object' ? userConfig?.overlay : null
   let checkers: ServeAndBuildChecker[] = []
   let viteMode: ConfigEnv['command'] | undefined
 
@@ -59,7 +65,6 @@ export default function Plugin(userConfig: UserPluginConfig): Plugin {
       checkers.forEach((checker) => {
         const workerConfig = checker.serve.config
         workerConfig({
-          // hmr: typeof hmr === 'object' ? { overlay: hmr.overlay } : hmr,
           enableOverlay,
           env,
         })
@@ -120,6 +125,13 @@ export default function Plugin(userConfig: UserPluginConfig): Plugin {
       let latestOverlayErrors: OverlayErrorAction['payload'][] = new Array(checkers.length)
       // for dev mode (2/2)
       // Get the server instance and keep reference in a closure
+      if (overlayConfig) {
+        server.ws.send({
+          type: 'custom',
+          event: WS_CHECKER_CONFIG_RUNTIME_EVENT,
+          data: overlayConfig,
+        })
+      }
       checkers.forEach((checker, index) => {
         const { worker, configureServer: workerConfigureServer } = checker.serve
         workerConfigureServer({ root: server.config.root })
@@ -143,6 +155,13 @@ export default function Plugin(userConfig: UserPluginConfig): Plugin {
           connectedTimes++
           // if connectedCount !== 1, means Vite is doing a full-reload, so we don't need to send overlay again
           if (connectedTimes > 1) {
+            if (overlayConfig) {
+              server.ws.send({
+                type: 'custom',
+                event: WS_CHECKER_CONFIG_RUNTIME_EVENT,
+                data: overlayConfig,
+              })
+            }
             server.ws.send({
               type: 'custom',
               event: WS_CHECKER_RECONNECT_EVENT,
diff --git a/packages/vite-plugin-checker/src/types.ts b/packages/vite-plugin-checker/src/types.ts
index 811f7596..ff570826 100644
--- a/packages/vite-plugin-checker/src/types.ts
+++ b/packages/vite-plugin-checker/src/types.ts
@@ -69,20 +69,24 @@ export interface SharedConfig {
    * @defaultValue
    * Same as [Vite config](https://vitejs.dev/config/#root)
    */
-  overlay: boolean
-  // TODO: not implemented
-  // | {
-  //     /**
-  //      * Set this true if you want the overlay to default to being open if errors/warnings are found.
-  //      * @defaultValue `true`
-  //      */
-  //     initialIsOpen?: boolean
-  //     /**
-  //      * The position of the vite-plugin-checker badge to open and close the diagnostics panel
-  //      * @default `bottom-left`
-  //      */
-  //     position?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right'
-  //   }
+  overlay:
+    | boolean
+    | {
+        /**
+         * Set this true if you want the overlay to default to being open if errors/warnings are found.
+         * @defaultValue `true`
+         */
+        initialIsOpen?: boolean
+        /**
+         * The position of the vite-plugin-checker badge to open and close the diagnostics panel
+         * @default `bl`
+         */
+        position?: 'tl' | 'tr' | 'bl' | 'br'
+        /**
+         * Use this to add extra style to the badge button
+         */
+        badgeStyle?: string
+      }
 }
 
 export interface BuildInCheckers {
@@ -124,7 +128,6 @@ export interface OverlayErrorAction extends Action {
 }
 
 interface ConfigActionPayload {
-  // hmr?: { overlay?: boolean } | boolean
   enableOverlay: boolean
   env: ConfigEnv
 }
diff --git a/playground/react-ts/__tests__/__snapshots__/overlay-true.spec.ts.snap b/playground/react-ts/__tests__/__snapshots__/overlay-true.spec.ts.snap
index ac9efcc8..2a377cab 100644
--- a/playground/react-ts/__tests__/__snapshots__/overlay-true.spec.ts.snap
+++ b/playground/react-ts/__tests__/__snapshots__/overlay-true.spec.ts.snap
@@ -1,10 +1,10 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
-exports[`overlay overlay prompts and changes 1`] = `"Argument of type 'number' is not assignable to parameter of type 'string | (() => string)'."`;
+exports[`overlay-true overlay prompts and changes 1`] = `"Argument of type 'number' is not assignable to parameter of type 'string | (() => string)'."`;
 
-exports[`overlay overlay prompts and changes 2`] = `"<PROJECT_ROOT>/temp/react-ts/src/App.tsx:6:46"`;
+exports[`overlay-true overlay prompts and changes 2`] = `"<PROJECT_ROOT>/temp/react-ts/src/App.tsx:6:46"`;
 
-exports[`overlay overlay prompts and changes 3`] = `
+exports[`overlay-true overlay prompts and changes 3`] = `
 "    4 |
     5 | function App() {
   > 6 |   const [count, setCount] = useState<string>(1)
@@ -14,7 +14,7 @@ exports[`overlay overlay prompts and changes 3`] = `
     9 |       <header className=\\"App-header\\">"
 `;
 
-exports[`overlay overlay prompts and changes 4`] = `
+exports[`overlay-true overlay prompts and changes 4`] = `
 "    4 |
     5 | function App() {
   > 6 |   const [count, setCount] = useState<string>(2)
diff --git a/playground/react-ts/__tests__/overlay-config.ts b/playground/react-ts/__tests__/overlay-config.ts
new file mode 100644
index 00000000..db4c12ec
--- /dev/null
+++ b/playground/react-ts/__tests__/overlay-config.ts
@@ -0,0 +1,50 @@
+import {
+  getHmrOverlayText,
+  killServer,
+  preTest,
+  viteServe,
+} from 'vite-plugin-checker/__tests__/e2e/Sandbox/Sandbox'
+import {
+  editFile,
+  sleep,
+  testDir,
+  WORKER_CLEAN_TIMEOUT,
+} from 'vite-plugin-checker/__tests__/e2e/testUtils'
+
+import { copyCode } from '../../../scripts/jestSetupFilesAfterEnv'
+import { serializers } from '../../../scripts/serializers'
+
+expect.addSnapshotSerializer(serializers)
+
+beforeAll(async () => {
+  await preTest()
+})
+
+afterAll(async () => {
+  await sleep(WORKER_CLEAN_TIMEOUT)
+})
+
+describe('overlay-config', () => {
+  beforeEach(async () => {
+    await copyCode()
+  })
+
+  afterEach(async () => {
+    await killServer()
+  })
+
+  it('overlay: config', async () => {
+    editFile('vite.config.ts', (code) =>
+      code.replace(
+        'typescript: true,',
+        `typescript: true, overlay: { position: 'br', initialIsOpen: false, },`
+      )
+    )
+
+    await viteServe({ cwd: testDir, launchPage: true })
+    await sleep(6000)
+    await expect(getHmrOverlayText()).rejects.toThrow(
+      'Invariant failed: <vite-plugin-checker-error-overlay> shadow dom is expected to be found, but got null'
+    )
+  })
+})
diff --git a/playground/react-ts/__tests__/overlay-false.spec.ts b/playground/react-ts/__tests__/overlay-false.spec.ts
index 0f174d63..c9584363 100644
--- a/playground/react-ts/__tests__/overlay-false.spec.ts
+++ b/playground/react-ts/__tests__/overlay-false.spec.ts
@@ -24,7 +24,7 @@ afterAll(async () => {
   await sleep(WORKER_CLEAN_TIMEOUT)
 })
 
-describe('overlay', () => {
+describe('overlay-false', () => {
   beforeEach(async () => {
     await copyCode()
   })
diff --git a/playground/react-ts/__tests__/overlay-true.spec.ts b/playground/react-ts/__tests__/overlay-true.spec.ts
index e3e8b6c9..fbc5a0bb 100644
--- a/playground/react-ts/__tests__/overlay-true.spec.ts
+++ b/playground/react-ts/__tests__/overlay-true.spec.ts
@@ -27,7 +27,7 @@ afterAll(async () => {
   await sleep(WORKER_CLEAN_TIMEOUT)
 })
 
-describe('overlay', () => {
+describe('overlay-true', () => {
   beforeEach(async () => {
     await copyCode()
   })