diff --git a/.github/workflows/test-on-push.yml b/.github/workflows/test-on-push.yml
index 9bc6e270..88f89cc7 100644
--- a/.github/workflows/test-on-push.yml
+++ b/.github/workflows/test-on-push.yml
@@ -29,3 +29,25 @@ jobs:
         run: npm install
       - name: Test the app
         run: npm run test
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+            node-version-file: '.node-version'
+      - name: Installing node_modules
+        run: npm install
+      - name: Run lint
+        run: npm run lint:check
+  typecheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+            node-version-file: '.node-version'
+      - name: Installing node_modules
+        run: npm install
+      - name: Run tsc
+        run: npm run tsc
diff --git a/package.json b/package.json
index 7467c173..364694e6 100644
--- a/package.json
+++ b/package.json
@@ -8,10 +8,13 @@
   ],
   "scripts": {
     "build": "lerna run build",
+    "lint:check": "lerna run lint:check",
+    "lint": "lerna run lint",
     "postinstall": "npm run build",
     "publish": "rm -f package-lock.json && rm -f packages/*/package-lock.json && lerna publish --no-private",
     "publish-docs": "lerna run publish-docs",
     "test": "lerna run test",
+    "tsc": "lerna run tsc",
     "watch": "lerna watch -- lerna run build --since"
   },
   "author": "Peter Szerzo <peter@nlx.ai>",
diff --git a/packages/chat-core/.eslintrc.cjs b/packages/chat-core/.eslintrc.cjs
new file mode 100644
index 00000000..5889268a
--- /dev/null
+++ b/packages/chat-core/.eslintrc.cjs
@@ -0,0 +1,5 @@
+/** @type {import('eslint').Linter.Config } */
+module.exports = {
+  root: true,
+  extends: ["nlx"],
+};
diff --git a/packages/chat-core/package.json b/packages/chat-core/package.json
index bec69382..3a3a7182 100644
--- a/packages/chat-core/package.json
+++ b/packages/chat-core/package.json
@@ -10,7 +10,10 @@
   "types": "lib/index.d.ts",
   "scripts": {
     "build": "rm -rf lib && rollup -c",
-    "prepublish": "npm run build"
+    "lint:check": "npx eslint src/ --ext .ts,.tsx,.js,.jsx",
+    "lint": "npx eslint src/ --ext .ts,.tsx,.js,.jsx --fix",
+    "prepublish": "npm run build",
+    "tsc": "tsc"
   },
   "author": "Peter Szerzo <peter@nlx.ai>",
   "license": "MIT",
@@ -25,6 +28,7 @@
     "@types/node": "^11.15.11",
     "@types/ramda": "0.29.1",
     "@types/uuid": "^9.0.7",
+    "eslint-config-nlx": "*",
     "prettier": "^3.1.0",
     "rollup": "^4.9.3",
     "rollup-plugin-node-polyfills": "^0.2.1",
diff --git a/packages/chat-core/src/index.ts b/packages/chat-core/src/index.ts
index b72ef174..c49cb57b 100644
--- a/packages/chat-core/src/index.ts
+++ b/packages/chat-core/src/index.ts
@@ -101,9 +101,7 @@ export interface Config {
   responses?: Response[];
   failureMessage?: string;
   environment?: Environment;
-  headers?: {
-    [key: string]: string;
-  };
+  headers?: Record<string, string>;
   languageCode: string;
   // Experimental settings
   experimental?: {
@@ -121,7 +119,7 @@ const defaultFailureMessage = "We encountered an issue. Please try again soon.";
 export type State = Response[];
 
 const normalizeSlots = (slotsWithLegacy: Slots | SlotValue[]): Slots => {
-  let slots: Slots = {};
+  const slots: Slots = {};
   if (Array.isArray(slotsWithLegacy)) {
     console.warn(
       `The legacy slot format is deprecated. Instead of '[{ slotId: "MySlot", value: "my-value" }]', use '{ MySlot: "my-value" }'`,
@@ -176,6 +174,8 @@ interface InternalState {
 const fromInternal = (internalState: InternalState): State =>
   internalState.responses;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 const safeJsonParse = (val: string) => {
   try {
     const json = JSON.parse(val);
@@ -185,7 +185,7 @@ const safeJsonParse = (val: string) => {
   }
 };
 
-type Subscriber = (response: Array<Response>, newResponse?: Response) => void;
+type Subscriber = (response: Response[], newResponse?: Response) => void;
 
 // Helper method to decide when a conversation needs to be re-initialized (e.g. bot URL change)
 export const shouldReinitialize = (
@@ -221,9 +221,13 @@ export const createConversation = (config: Config): ConversationHandler => {
     );
   }
 
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
   const initialConversationId = config.conversationId || uuid();
 
   let state: InternalState = {
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
     responses: config.responses || [],
     userId: config.userId,
     conversationId: initialConversationId,
@@ -239,15 +243,19 @@ export const createConversation = (config: Config): ConversationHandler => {
       ...change,
     };
     subscribers.forEach((subscriber) =>
-      subscriber(fromInternal(state), newResponse),
+      { subscriber(fromInternal(state), newResponse); },
     );
   };
 
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
   const failureHandler = () => {
     const newResponse: Response = {
       type: "failure",
       receivedAt: new Date().getTime(),
       payload: {
+        // initial eslint integration
+        // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
         text: config.failureMessage || defaultFailureMessage,
       },
     };
@@ -259,8 +267,12 @@ export const createConversation = (config: Config): ConversationHandler => {
     );
   };
 
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
   const messageResponseHandler = (response: any) => {
-    if (response && response.messages) {
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
+    if (response?.messages) {
       const newResponse: Response = {
         type: "bot",
         receivedAt: new Date().getTime(),
@@ -269,6 +281,8 @@ export const createConversation = (config: Config): ConversationHandler => {
           messages: response.messages.map((message: any) => ({
             messageId: message.messageId,
             text: message.text,
+            // initial eslint integration
+            // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
             choices: message.choices || [],
           })),
         },
@@ -279,9 +293,13 @@ export const createConversation = (config: Config): ConversationHandler => {
         },
         newResponse,
       );
+      // initial eslint integration
+      // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
       if (response.metadata.hasPendingDataRequest) {
         appendStructuredUserResponse({ poll: true });
         setTimeout(() => {
+          // initial eslint integration
+          // eslint-disable-next-line @typescript-eslint/no-floating-promises
           sendToBot({
             request: {
               structured: {
@@ -304,7 +322,9 @@ export const createConversation = (config: Config): ConversationHandler => {
   let socketMessageQueueCheckInterval: ReturnType<typeof setInterval> | null =
     null;
 
-  const sendToBot = (body: BotRequest) => {
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
+  const sendToBot = async (body: BotRequest) => {
     const bodyWithContext = {
       userId: state.userId,
       conversationId: state.conversationId,
@@ -313,20 +333,28 @@ export const createConversation = (config: Config): ConversationHandler => {
       channelType: config.experimental?.channelType,
       environment: config.environment,
     };
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
     if (isUsingWebSockets()) {
+      // initial eslint integration
+      // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
       if (socket && socket.readyState === 1) {
         socket.send(JSON.stringify(bodyWithContext));
       } else {
         socketMessageQueue = [...socketMessageQueue, bodyWithContext];
       }
     } else {
-      return fetch(
+      await fetch(
         `${config.botUrl}${
+          // initial eslint integration
+          // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
           config.experimental?.completeBotUrl ? "" : `-${config.languageCode}`
         }`,
         {
           method: "POST",
           headers: {
+            // initial eslint integration
+            // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
             ...(config.headers || {}),
             Accept: "application/json",
             "Content-Type": "application/json",
@@ -334,36 +362,52 @@ export const createConversation = (config: Config): ConversationHandler => {
           body: JSON.stringify(bodyWithContext),
         },
       )
-        .then((res) => {
-          return res.json();
+        .then(async (res) => {
+          return await res.json();
         })
         .then(messageResponseHandler)
         .catch((err) => {
           console.warn(err);
           failureHandler();
-        });
+        }); 
     }
   };
 
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
   const isUsingWebSockets = () => {
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
     return config.botUrl && config.botUrl.indexOf("wss://") === 0;
   };
 
   let subscribers: Subscriber[] = [];
 
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
   const checkQueue = () => {
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
     if (socket?.readyState === 1 && socketMessageQueue[0]) {
+      // initial eslint integration
+      // eslint-disable-next-line @typescript-eslint/no-floating-promises
       sendToBot(socketMessageQueue[0]);
       socketMessageQueue = socketMessageQueue.slice(1);
     }
   };
 
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
   const setupWebsocket = () => {
     const url = new URL(config.botUrl);
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
     if (!config.experimental?.completeBotUrl) {
       url.searchParams.set("languageCode", config.languageCode);
       url.searchParams.set(
         "channelKey",
+        // initial eslint integration
+        // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
         `${url.searchParams.get("channelKey") || ""}-${config.languageCode}`,
       );
     }
@@ -377,10 +421,16 @@ export const createConversation = (config: Config): ConversationHandler => {
     };
   };
 
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
   const teardownWebsocket = () => {
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
     if (socketMessageQueueCheckInterval) {
       clearInterval(socketMessageQueueCheckInterval);
     }
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
     if (socket) {
       socket.onmessage = null;
       socket.close();
@@ -388,6 +438,8 @@ export const createConversation = (config: Config): ConversationHandler => {
     }
   };
 
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
   if (isUsingWebSockets()) {
     setupWebsocket();
   }
@@ -395,6 +447,8 @@ export const createConversation = (config: Config): ConversationHandler => {
   const appendStructuredUserResponse = (
     structured: StructuredRequest,
     context?: Context,
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
   ) => {
     const newResponse: Response = {
       type: "user",
@@ -413,8 +467,12 @@ export const createConversation = (config: Config): ConversationHandler => {
     );
   };
 
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
   const sendIntent = (intentId: string, context?: Context) => {
     appendStructuredUserResponse({ intentId }, context);
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/no-floating-promises
     sendToBot({
       context,
       request: {
@@ -425,6 +483,8 @@ export const createConversation = (config: Config): ConversationHandler => {
     });
   };
 
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
   const sendText = (text: string, context?: Context) => {
     const newResponse: Response = {
       type: "user",
@@ -441,6 +501,8 @@ export const createConversation = (config: Config): ConversationHandler => {
       },
       newResponse,
     );
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/no-floating-promises
     sendToBot({
       context,
       request: {
@@ -451,10 +513,14 @@ export const createConversation = (config: Config): ConversationHandler => {
     });
   };
 
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
   const unsubscribe = (subscriber: Subscriber) => {
     subscribers = subscribers.filter((fn) => fn !== subscriber);
   };
 
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
   const subscribe = (subscriber: Subscriber) => {
     subscribers = [...subscribers, subscriber];
     subscriber(fromInternal(state));
@@ -467,6 +533,8 @@ export const createConversation = (config: Config): ConversationHandler => {
     sendText,
     sendStructured: (structured: StructuredRequest, context) => {
       appendStructuredUserResponse(structured, context);
+      // initial eslint integration
+      // eslint-disable-next-line @typescript-eslint/no-floating-promises
       sendToBot({
         context,
         request: {
@@ -477,6 +545,8 @@ export const createConversation = (config: Config): ConversationHandler => {
     sendSlots: (slotsWithLegacy, context) => {
       const slots = normalizeSlots(slotsWithLegacy);
       appendStructuredUserResponse({ slots }, context);
+      // initial eslint integration
+      // eslint-disable-next-line @typescript-eslint/no-floating-promises
       sendToBot({
         context,
         request: {
@@ -491,10 +561,14 @@ export const createConversation = (config: Config): ConversationHandler => {
       sendIntent(welcomeIntent, context);
     },
     sendChoice: (choiceId, context) => {
+      // initial eslint integration
+      // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
       const containsChoice = (botMessage: BotMessage) =>
+        // initial eslint integration
+        // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
         (botMessage.choices || [])
           .map((choice) => choice.choiceId)
-          .indexOf(choiceId) > -1;
+          .includes(choiceId);
 
       const lastBotResponseIndex = findLastIndex(
         (response: Response) =>
@@ -548,6 +622,8 @@ export const createConversation = (config: Config): ConversationHandler => {
         choiceResponse,
       );
 
+      // initial eslint integration
+      // eslint-disable-next-line @typescript-eslint/no-floating-promises
       sendToBot({
         context,
         request: {
@@ -568,8 +644,12 @@ export const createConversation = (config: Config): ConversationHandler => {
     reset: (options) => {
       setState({
         conversationId: uuid(),
+        // initial eslint integration
+        // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
         responses: options?.clearResponses ? [] : state.responses,
       });
+      // initial eslint integration
+      // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
       if (isUsingWebSockets()) {
         teardownWebsocket();
         setupWebsocket();
@@ -577,6 +657,8 @@ export const createConversation = (config: Config): ConversationHandler => {
     },
     destroy: () => {
       subscribers = [];
+      // initial eslint integration
+      // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
       if (isUsingWebSockets()) {
         teardownWebsocket();
       }
@@ -589,15 +671,21 @@ export function promisify<T>(
   convo: ConversationHandler,
   timeout = 10000,
 ): (payload: T) => Promise<Response | null> {
-  return (payload: T) => {
-    return new Promise((resolve, reject) => {
+  return async (payload: T) => {
+    return await new Promise((resolve, reject) => {
       const timeoutId = setTimeout(() => {
+        // initial eslint integration
+        // eslint-disable-next-line prefer-promise-reject-errors
         reject("The request timed out.");
       }, timeout);
       const subscription = (
         _responses: Response[],
         newResponse: Response | undefined,
+      // initial eslint integration
+      // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
       ) => {
+        // initial eslint integration
+        // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
         if (newResponse && newResponse.type === "bot") {
           clearTimeout(timeoutId);
           convo.unsubscribe(subscription);
diff --git a/packages/chat-core/tsconfig.json b/packages/chat-core/tsconfig.json
index fb9e5158..87cc7778 100644
--- a/packages/chat-core/tsconfig.json
+++ b/packages/chat-core/tsconfig.json
@@ -2,6 +2,7 @@
   "compilerOptions": {
     "target": "es6",
     "module": "esnext",
+    "moduleResolution": "bundler",
     "declaration": true,
     "outDir": "./lib",
     "rootDir": "./src",
diff --git a/packages/chat-preact/.eslintrc.cjs b/packages/chat-preact/.eslintrc.cjs
new file mode 100644
index 00000000..4885ad56
--- /dev/null
+++ b/packages/chat-preact/.eslintrc.cjs
@@ -0,0 +1,6 @@
+/** @type {import('eslint').Linter.Config } */
+module.exports = {
+  root: true,
+  // appears that the preact eslint plugin isn't compatible with typescript
+  extends: ["nlx"],
+};
diff --git a/packages/chat-preact/package.json b/packages/chat-preact/package.json
index 49e5696d..b573626c 100644
--- a/packages/chat-preact/package.json
+++ b/packages/chat-preact/package.json
@@ -9,7 +9,10 @@
   "types": "lib/index.d.ts",
   "scripts": {
     "build": "rm -rf lib && rollup -c",
-    "prepublish": "npm run build"
+    "lint:check": "npx eslint src/ --ext .ts,.tsx,.js,.jsx",
+    "lint": "npx eslint src/ --ext .ts,.tsx,.js,.jsx --fix",
+    "prepublish": "npm run build",
+    "tsc": "tsc"
   },
   "author": "Peter Szerzo <peter@nlx.ai>",
   "license": "MIT",
@@ -22,6 +25,7 @@
     "@rollup/plugin-typescript": "^11.1.5",
     "@types/node": "^11.15.11",
     "@types/ramda": "0.29.1",
+    "eslint-config-nlx": "*",
     "prettier": "^3.0.3",
     "rollup": "^4.3.0",
     "rollup-plugin-node-polyfills": "^0.2.1",
diff --git a/packages/chat-preact/src/index.ts b/packages/chat-preact/src/index.ts
index d0316b40..0db8d9d4 100755
--- a/packages/chat-preact/src/index.ts
+++ b/packages/chat-preact/src/index.ts
@@ -3,17 +3,17 @@ import { useState, useEffect, useRef, useMemo } from "preact/hooks";
 // Code from here on out is identical in the React and Preact packages
 import { last } from "ramda";
 import createConversation, {
-  Config,
-  ConversationHandler,
+  type Config,
+  type ConversationHandler,
   shouldReinitialize,
-  Response
+  type Response,
 } from "@nlxai/chat-core";
 
 export interface ChatHook {
   conversationHandler: ConversationHandler;
   inputValue: string;
   setInputValue: (val: string) => void;
-  responses: Array<Response>;
+  responses: Response[];
   waiting: boolean;
 }
 
@@ -28,8 +28,8 @@ export const useChat = (config: Config): ChatHook => {
   const conversationHandler: ConversationHandler = useMemo(() => {
     // Prevent re-initialization if backend-related props have not changed
     if (
-      prevConfig.current &&
-      prevConversationHandler.current &&
+      prevConfig.current != null &&
+      prevConversationHandler.current != null &&
       !shouldReinitialize(prevConfig.current, config)
     ) {
       return prevConversationHandler.current;
@@ -39,7 +39,7 @@ export const useChat = (config: Config): ChatHook => {
     return newHandler;
   }, [config]);
 
-  const [responses, setResponses] = useState<Array<Response>>([]);
+  const [responses, setResponses] = useState<Response[]>([]);
 
   const [inputValue, setInputValue] = useState<string>("");
 
@@ -52,14 +52,14 @@ export const useChat = (config: Config): ChatHook => {
   }, [conversationHandler]);
 
   const lastMessage = last<Response>(responses);
-  const isWaiting = lastMessage ? lastMessage.type === "user" : false;
+  const isWaiting = lastMessage?.type === "user";
 
   return {
     conversationHandler,
     inputValue,
     responses,
     waiting: isWaiting,
-    setInputValue
+    setInputValue,
   };
 };
 
diff --git a/packages/chat-react/.eslintrc.cjs b/packages/chat-react/.eslintrc.cjs
new file mode 100644
index 00000000..4885ad56
--- /dev/null
+++ b/packages/chat-react/.eslintrc.cjs
@@ -0,0 +1,6 @@
+/** @type {import('eslint').Linter.Config } */
+module.exports = {
+  root: true,
+  // appears that the preact eslint plugin isn't compatible with typescript
+  extends: ["nlx"],
+};
diff --git a/packages/chat-react/package.json b/packages/chat-react/package.json
index 3e589db4..655b6d6b 100644
--- a/packages/chat-react/package.json
+++ b/packages/chat-react/package.json
@@ -9,7 +9,10 @@
   "types": "lib/index.d.ts",
   "scripts": {
     "build": "rm -rf lib && rollup -c",
-    "prepublish": "npm run build"
+    "lint:check": "npx eslint src/ --ext .ts,.tsx,.js,.jsx",
+    "lint": "npx eslint src/ --ext .ts,.tsx,.js,.jsx --fix",
+    "prepublish": "npm run build",
+    "tsc": "tsc"
   },
   "author": "Peter Szerzo <peter@nlx.ai>",
   "license": "MIT",
@@ -24,6 +27,7 @@
     "@types/ramda": "0.29.1",
     "@types/react": "^18.2.21",
     "@types/react-dom": "^18.2.7",
+    "eslint-config-nlx": "*",
     "prettier": "^3.0.3",
     "rollup": "^4.3.0",
     "rollup-plugin-node-polyfills": "^0.2.1",
diff --git a/packages/chat-react/src/index.ts b/packages/chat-react/src/index.ts
index a799179b..ae680294 100755
--- a/packages/chat-react/src/index.ts
+++ b/packages/chat-react/src/index.ts
@@ -3,17 +3,17 @@ import { useState, useEffect, useRef, useMemo } from "react";
 // Code from here on out is identical in the React and Preact packages
 import { last } from "ramda";
 import createConversation, {
-  Config,
-  ConversationHandler,
+  type Config,
+  type ConversationHandler,
   shouldReinitialize,
-  Response
+  type Response,
 } from "@nlxai/chat-core";
 
 export interface ChatHook {
   conversationHandler: ConversationHandler;
   inputValue: string;
   setInputValue: (val: string) => void;
-  responses: Array<Response>;
+  responses: Response[];
   waiting: boolean;
 }
 
@@ -28,8 +28,8 @@ export const useChat = (config: Config): ChatHook => {
   const conversationHandler: ConversationHandler = useMemo(() => {
     // Prevent re-initialization if backend-related props have not changed
     if (
-      prevConfig.current &&
-      prevConversationHandler.current &&
+      prevConfig.current != null &&
+      prevConversationHandler.current != null &&
       !shouldReinitialize(prevConfig.current, config)
     ) {
       return prevConversationHandler.current;
@@ -39,7 +39,7 @@ export const useChat = (config: Config): ChatHook => {
     return newHandler;
   }, [config]);
 
-  const [responses, setResponses] = useState<Array<Response>>([]);
+  const [responses, setResponses] = useState<Response[]>([]);
 
   const [inputValue, setInputValue] = useState<string>("");
 
@@ -52,14 +52,14 @@ export const useChat = (config: Config): ChatHook => {
   }, [conversationHandler]);
 
   const lastMessage = last<Response>(responses);
-  const isWaiting = lastMessage ? lastMessage.type === "user" : false;
+  const isWaiting = lastMessage?.type === "user";
 
   return {
     conversationHandler,
     inputValue,
     responses,
     waiting: isWaiting,
-    setInputValue
+    setInputValue,
   };
 };
 
diff --git a/packages/chat-react/tsconfig.json b/packages/chat-react/tsconfig.json
index e875977d..7d6e65a0 100644
--- a/packages/chat-react/tsconfig.json
+++ b/packages/chat-react/tsconfig.json
@@ -2,6 +2,7 @@
   "compilerOptions": {
     "target": "es6",
     "module": "esnext",
+    "moduleResolution": "bundler",
     "lib": ["dom"],
     "jsx": "react",
     "declaration": true,
diff --git a/packages/chat-widget/.eslintrc.cjs b/packages/chat-widget/.eslintrc.cjs
new file mode 100644
index 00000000..5889268a
--- /dev/null
+++ b/packages/chat-widget/.eslintrc.cjs
@@ -0,0 +1,5 @@
+/** @type {import('eslint').Linter.Config } */
+module.exports = {
+  root: true,
+  extends: ["nlx"],
+};
diff --git a/packages/chat-widget/package.json b/packages/chat-widget/package.json
index ca04b823..aeb09a24 100644
--- a/packages/chat-widget/package.json
+++ b/packages/chat-widget/package.json
@@ -10,7 +10,10 @@
   "types": "lib/index.d.ts",
   "scripts": {
     "build": "rm -rf lib && rollup -c",
-    "prepublish": "npm run build"
+    "lint:check": "npx eslint src/ --ext .ts,.tsx,.js,.jsx",
+    "lint": "npx eslint src/ --ext .ts,.tsx,.js,.jsx --fix",
+    "prepublish": "npm run build",
+    "tsc": "tsc"
   },
   "author": "Peter Szerzo <peter@nlx.ai>",
   "license": "MIT",
@@ -26,6 +29,7 @@
     "@types/react": "^18.2.21",
     "@types/react-dom": "^18.2.7",
     "@types/tinycolor2": "^1.4.2",
+    "eslint-config-nlx": "*",
     "prettier": "^3.0.3",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
diff --git a/packages/chat-widget/src/icons.tsx b/packages/chat-widget/src/icons.tsx
index da80081a..4f459032 100644
--- a/packages/chat-widget/src/icons.tsx
+++ b/packages/chat-widget/src/icons.tsx
@@ -1,29 +1,39 @@
 import React from "react";
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const CloseIcon = () => (
   <svg viewBox="-50 -50 460 460" stroke="none" fill="currentColor">
     <path d="M180,151.716l105.858,-105.858c9.428,9.428 18.856,18.856 28.284,28.284l-105.858,105.858l105.858,105.858l-28.284,28.284l-105.858,-105.858l-105.858,105.858l-28.284,-28.284l105.858,-105.858l-105.858,-105.858l28.284,-28.284l105.858,105.858Z" />
   </svg>
 );
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const ChatIcon = () => (
   <svg viewBox="0 0 24 24" stroke="none" fill="currentColor">
     <path d="M20 2H4c-1.1 0-2 .9-2 2v18l4-4h14c1.1 0 2-.9 2-2V4c0-1.1-.9-2-2-2z" />
   </svg>
 );
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const AirplaneIcon = () => (
   <svg viewBox="0 0 360 360" stroke="none" fill="currentColor">
     <path d="M70.245,313.177c-1.501,4.001 -0.293,8.513 3.006,11.23c3.298,2.717 7.959,3.037 11.598,0.797c53.773,-33.091 179.453,-110.432 221.312,-136.191c2.957,-1.82 4.759,-5.044 4.759,-8.517c0,-3.473 -1.802,-6.696 -4.759,-8.516c-41.625,-25.615 -166.135,-102.237 -220.403,-135.633c-3.673,-2.26 -8.382,-1.911 -11.681,0.867c-3.3,2.779 -4.446,7.359 -2.844,11.364c14.572,36.431 39.018,97.546 46.514,116.285c1.385,3.462 4.58,5.866 8.29,6.237c10.635,1.063 33.534,3.353 54.062,5.406c1.061,0.106 1.852,1.025 1.799,2.09c-0.053,1.064 -0.932,1.9 -1.998,1.9c-19.919,0 -42.022,0 -52.97,0c-4.168,0 -7.9,2.586 -9.363,6.489c-7.878,21.008 -33.004,88.011 -47.322,126.192Z" />
   </svg>
 );
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const DownloadIcon = () => (
   <svg viewBox="0 0 360 360" stroke="none" fill="currentColor">
     <path d="M320,320.496l-280,0l0,-40l280,0l0,40Zm-120,-148.284l40,-40c9.428,9.428 18.856,18.856 28.284,28.284l-88.284,88.284l-28.284,-28.284l0,0l-60,-60l28.284,-28.284l40,40l0,-131.716l40,0l0,131.716Z" />
   </svg>
 );
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const ErrorOutlineIcon = () => (
   <svg viewBox="0 0 24 24" stroke="none" fill="currentColor">
     <path d="M11 15h2v2h-2zm0-8h2v6h-2zm.99-5C6.47 2 2 6.48 2 12s4.47 10 9.99 10C17.52 22 22 17.52 22 12S17.52 2 11.99 2zM12 20c-4.42 0-8-3.58-8-8s3.58-8 8-8 8 3.58 8 8-3.58 8-8 8z" />
diff --git a/packages/chat-widget/src/index.tsx b/packages/chat-widget/src/index.tsx
index 32abd136..7de758b3 100644
--- a/packages/chat-widget/src/index.tsx
+++ b/packages/chat-widget/src/index.tsx
@@ -97,6 +97,8 @@ const Loader: FC<{ message?: string; showAfter?: number }> = (props) => {
   return (
     <C.LoaderContainer>
       <C.PendingMessageDots />
+      {/* initial eslint integration */}
+      {/* eslint-disable-next-line @typescript-eslint/strict-boolean-expressions */}
       {showMessage && props.message && (
         <C.LoaderText>{props.message}</C.LoaderText>
       )}
@@ -110,6 +112,8 @@ const MessageGroups: FC<{
   customModalities: Record<string, CustomModalityComponent>;
 }> = (props) => (
   <C.MessageGroups>
+    {/* initial eslint integration */}
+    {/* eslint-disable-next-line array-callback-return */}
     {props.chat.responses.map((response, responseIndex) => {
       if (response.type === "bot") {
         return (
@@ -127,6 +131,8 @@ const MessageGroups: FC<{
                       <C.ChoiceButton
                         key={choiceIndex}
                         {...(() => {
+                          // initial eslint integration
+                          // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
                           return botMessage.selectedChoiceId
                             ? {
                                 disabled: true,
@@ -145,6 +151,8 @@ const MessageGroups: FC<{
                         dangerouslySetInnerHTML={{
                           __html: marked(
                             choice.choiceText +
+                              // initial eslint integration
+                              // eslint-disable-next-line no-constant-condition
                               (false ? " asdf fadsfds  fdsa fdsa fdsa " : ""),
                           ),
                         }}
@@ -154,9 +162,13 @@ const MessageGroups: FC<{
                 )}
               </C.Message>
             ))}
+            {/* initial eslint integration */}
+            {/* eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing */}
             {Object.entries(response.payload.modalities || {}).map(
               ([key, value]) => {
                 const Component = props.customModalities[key];
+                // initial eslint integration
+                // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
                 if (Component) {
                   return <Component key={key} data={value} />;
                 }
@@ -201,6 +213,8 @@ interface SessionData {
   responses: Response[];
 }
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 const saveSession = (chat: ChatHook, storeIn: StorageType) => {
   const storage = storeIn === "sessionStorage" ? sessionStorage : localStorage;
   storage.setItem(
@@ -212,6 +226,8 @@ const saveSession = (chat: ChatHook, storeIn: StorageType) => {
   );
 };
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const clearSession = (storeIn: StorageType) => {
   const storage = storeIn === "sessionStorage" ? sessionStorage : localStorage;
   storage.removeItem(storageKey);
@@ -221,16 +237,24 @@ export const retrieveSession = (storeIn: StorageType): SessionData | null => {
   try {
     const storage =
       storeIn === "sessionStorage" ? sessionStorage : localStorage;
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
     const data = JSON.parse(storage.getItem(storageKey) || "");
     const responses: Response[] | undefined = data?.responses;
     const conversationId: string | undefined = data?.conversationId;
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
     if (responses) {
-      let expirationTimestamp: number | undefined = undefined;
+      let expirationTimestamp: number | undefined;
       responses.forEach((response) => {
+        // initial eslint integration
+        // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
         if (response.type === "bot" && response.payload.expirationTimestamp) {
           expirationTimestamp = response.payload.expirationTimestamp;
         }
       });
+      // initial eslint integration
+      // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
       if (!expirationTimestamp || new Date().getTime() < expirationTimestamp) {
         return { responses, conversationId };
       } else {
@@ -247,10 +271,14 @@ const ConversationHandlerContext = createContext<ConversationHandler | null>(
   null,
 );
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const useConversationHandler = () => {
   return useContext(ConversationHandlerContext);
 };
 
+// initial eslint integration
+// eslint-disable-next-line react/display-name
 export const Widget = forwardRef<WidgetRef, Props>((props, ref) => {
   const [windowInnerHeightValue, setWindowInnerHeightValue] = useState<
     number | null
@@ -258,6 +286,8 @@ export const Widget = forwardRef<WidgetRef, Props>((props, ref) => {
 
   useEffect(() => {
     setWindowInnerHeightValue(window.innerHeight);
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
     const handleResize = () => {
       setWindowInnerHeightValue(window.innerHeight);
     };
@@ -268,18 +298,26 @@ export const Widget = forwardRef<WidgetRef, Props>((props, ref) => {
   }, []);
 
   const savedSessionData = useMemo(
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
     () => (props.storeIn ? retrieveSession(props.storeIn) : null),
     [props.storeIn],
   );
 
   const configWithSession = useMemo(() => {
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
     if (!savedSessionData) {
       return props.config;
     }
     return {
       ...props.config,
       conversationId:
+        // initial eslint integration
+        // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
         savedSessionData.conversationId || props.config.conversationId,
+      // initial eslint integration
+      // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
       responses: savedSessionData.responses || props.config.responses,
     };
   }, [props.config, savedSessionData]);
@@ -289,6 +327,8 @@ export const Widget = forwardRef<WidgetRef, Props>((props, ref) => {
   const chat = useChat(configWithSession);
 
   useEffect(() => {
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
     if (props.storeIn) {
       saveSession(chat, props.storeIn);
     }
@@ -327,6 +367,8 @@ export const Widget = forwardRef<WidgetRef, Props>((props, ref) => {
   const inputRef = useRef(null);
 
   useEffect(() => {
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-optional-chain
     if (inputRef && inputRef.current) {
       (inputRef as any).current.focus();
     }
@@ -341,6 +383,8 @@ export const Widget = forwardRef<WidgetRef, Props>((props, ref) => {
   // Escape handling
 
   useEffect(() => {
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
     const handler = (ev: KeyboardEvent) => {
       if (ev.key === "Escape") {
         setExpanded(false);
@@ -375,6 +419,8 @@ export const Widget = forwardRef<WidgetRef, Props>((props, ref) => {
 
   const scrollToBottom = useCallback(() => {
     const node = messagesContainerRef.current;
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
     if (node) {
       node.scrollTop = node.scrollHeight;
     }
@@ -393,6 +439,8 @@ export const Widget = forwardRef<WidgetRef, Props>((props, ref) => {
       chat.setInputValue("");
     });
 
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
   const dateTimestamp = useMemo(() => {
     const d = new Date();
     return `${d.getFullYear()}-${toStringWithLeadingZero(
@@ -405,6 +453,8 @@ export const Widget = forwardRef<WidgetRef, Props>((props, ref) => {
   const mergedTheme = useMemo(
     () => ({
       ...constants.defaultTheme,
+      // initial eslint integration
+      // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
       ...(props.theme || {}),
       windowInnerHeight: windowInnerHeightValue,
     }),
@@ -415,6 +465,8 @@ export const Widget = forwardRef<WidgetRef, Props>((props, ref) => {
     <ConversationHandlerContext.Provider value={chat.conversationHandler}>
       <ThemeProvider theme={mergedTheme}>
         <>
+          {/* initial eslint integration */}
+          {/* eslint-disable-next-line @typescript-eslint/strict-boolean-expressions */}
           {props.bubble ? (
             <C.PinBubble
               isActive={!expanded && bubble}
@@ -427,9 +479,13 @@ export const Widget = forwardRef<WidgetRef, Props>((props, ref) => {
           {expanded && (
             <C.Container>
               <C.Main ref={messagesContainerRef}>
+                {/* initial eslint integration */}
+                {/* eslint-disable-next-line @typescript-eslint/strict-boolean-expressions */}
                 {props.titleBar && (
                   <C.TitleBar>
                     <C.TitleContainer>
+                      {/* initial eslint integration */}
+                      {/* eslint-disable-next-line @typescript-eslint/strict-boolean-expressions */}
                       {props.titleBar.logo && (
                         <C.TitleIcon src={props.titleBar.logo} />
                       )}
@@ -439,6 +495,8 @@ export const Widget = forwardRef<WidgetRef, Props>((props, ref) => {
                 )}
                 <MessageGroups
                   chat={chat}
+                  // initial eslint integration
+                  // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
                   customModalities={props.customModalities || {}}
                 >
                   {chat.waiting && (
@@ -457,11 +515,17 @@ export const Widget = forwardRef<WidgetRef, Props>((props, ref) => {
                 <C.Input
                   ref={inputRef}
                   value={chat.inputValue}
+                  // initial eslint integration
+                  // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
                   placeholder={props.inputPlaceholder || "Type something..."}
                   onChange={(event: any) => {
+                    // initial eslint integration
+                    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
                     chat.setInputValue(event.target.value);
                   }}
                   onKeyPress={(event: any) => {
+                    // initial eslint integration
+                    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
                     if (event.key === "Enter" && submit) {
                       submit();
                     }
@@ -469,8 +533,12 @@ export const Widget = forwardRef<WidgetRef, Props>((props, ref) => {
                 />
                 <C.BottomButtonsContainer>
                   <C.IconButton
+                    // initial eslint integration
+                    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
                     disabled={Boolean(!submit)}
                     onClick={() => {
+                      // initial eslint integration
+                      // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
                       if (submit) {
                         submit();
                       }
@@ -489,6 +557,8 @@ export const Widget = forwardRef<WidgetRef, Props>((props, ref) => {
           >
             {expanded ? (
               <CloseIcon />
+            // initial eslint integration
+            // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
             ) : props.chatIcon ? (
               <img src={props.chatIcon} />
             ) : (
diff --git a/packages/chat-widget/src/types.d.ts b/packages/chat-widget/src/types.d.ts
index db95c5e4..464bb593 100644
--- a/packages/chat-widget/src/types.d.ts
+++ b/packages/chat-widget/src/types.d.ts
@@ -1,3 +1,5 @@
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
 import { type Theme as ThemeType } from "./theme";
 import "@emotion/react";
 
diff --git a/packages/chat-widget/src/ui/components.tsx b/packages/chat-widget/src/ui/components.tsx
index 293caee8..cfb656ac 100644
--- a/packages/chat-widget/src/ui/components.tsx
+++ b/packages/chat-widget/src/ui/components.tsx
@@ -1,7 +1,7 @@
 import React from "react";
 import styled from "@emotion/styled";
 import { keyframes } from "@emotion/react";
-import { Theme } from "../theme";
+import { type Theme } from "../theme";
 import * as constants from "./constants";
 import tinycolor from "tinycolor2";
 
@@ -20,6 +20,8 @@ export const hoverBg = `
   }
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const focusShadow = (theme: Theme) => `
   box-shadow: 0 0 0 3px ${tinycolor(theme.primaryColor)
     .setAlpha(0.15)
@@ -47,6 +49,8 @@ const bounceKeyframes = keyframes`
 `;
 
 // The 'display: block !important' rule circumvents typical base CSS rules that set 'display: none' on empty HTML elements
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 const Dot = styled.div<{}>`
   display: block !important;
   width: 6px;
@@ -70,6 +74,8 @@ const Dot = styled.div<{}>`
   }
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 const DotsContainer = styled.div<{}>`
   display: flex;
   align-items: center;
@@ -77,16 +83,22 @@ const DotsContainer = styled.div<{}>`
   padding: 4px 0;
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const LoaderContainer = styled.div<{}>`
   display: flex;
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const LoaderText = styled.span<{}>`
   display: inline-block;
   margin-left: 10px;
   font-size: ${constants.fontSize}px;
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const PendingMessageDots: React.FunctionComponent<{}> = () => (
   <DotsContainer>
     <Dot />
@@ -100,9 +112,13 @@ export const PendingMessageDots: React.FunctionComponent<{}> = () => (
 const top = 20;
 const bottom = 90;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const Container = styled.div<{}>`
   position: fixed;
   top: ${(props) => {
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
     if (!props.theme.windowInnerHeight) {
       return `${top}px`;
     }
@@ -132,6 +148,8 @@ export const Container = styled.div<{}>`
 
 // Main
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const Main = styled.div<{}>`
   height: calc(100% - ${constants.bottomHeight}px);
   overflow: auto;
@@ -139,6 +157,8 @@ export const Main = styled.div<{}>`
 
 // MessageGroups
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const MessageGroups = styled.div<{}>`
   padding: ${(props) => props.theme.spacing}px;
   box-sizing: border-box;
@@ -157,6 +177,8 @@ export const MessageGroups = styled.div<{}>`
 
 // MessageGroup
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const MessageGroup = styled.div<{}>`
   display: flex;
   flex-direction: column;
@@ -207,6 +229,8 @@ export const Message = styled.div<{ type: "user" | "bot" }>`
   }
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const FailureMessage = styled.p<{}>`
   text-align: center;
   flex-wrap: wrap;
@@ -226,6 +250,8 @@ export const FailureMessage = styled.p<{}>`
 
 // MessageBody
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const MessageBody = styled.p<{}>`
   margin: 0;
   font-size: ${constants.fontSize}px;
@@ -246,6 +272,8 @@ export const MessageBody = styled.p<{}>`
 
 // Bottom
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const Bottom = styled.div<{}>`
   height: ${constants.bottomHeight}px;
   position: relative;
@@ -262,6 +290,8 @@ export const IconButton = styled.button<{ disabled?: boolean }>`
   padding: 8px;
   font-size: ${constants.fontSize}px;
   ${(props) =>
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
     props.disabled
       ? `
   opacity: 0.6;
@@ -291,6 +321,8 @@ export const IconButton = styled.button<{ disabled?: boolean }>`
   ${hoverBg}
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const BottomButtonsContainer = styled.div<{}>`
   position: absolute;
   top: 50%;
@@ -298,6 +330,8 @@ export const BottomButtonsContainer = styled.div<{}>`
   transform: translate3d(0, -50%, 0);
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const Input = styled.input<{}>`
   display: block;
   flex: 1;
@@ -314,6 +348,8 @@ export const Input = styled.input<{}>`
   }
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const Pin = styled.button<{}>`
   position: fixed;
   background-color: ${(props) => props.theme.primaryColor};
@@ -415,6 +451,8 @@ export const PinBubbleContainer = styled.div<{
 
 // PinBubbleButton
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const PinBubbleButton = styled.button<{}>`
   width: 32px;
   height: 32px;
@@ -446,6 +484,8 @@ export const PinBubbleButton = styled.button<{}>`
 
 // ChoicesContainer
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const ChoicesContainer = styled.div<{}>`
   margin-top: 10px;
   margin-bottom: -6px;
@@ -472,6 +512,8 @@ export const ChoiceButton = styled.button<{
   color: ${props.theme.white};
   `}
   ${(props) =>
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
     props.selected
       ? `
   outline: 2px solid ${props.theme.primaryColor};
@@ -483,6 +525,8 @@ export const ChoiceButton = styled.button<{
     const hoverColor = tinycolor(props.theme.primaryColor)
       .brighten(5)
       .toRgbString();
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
     return props.disabled
       ? `
   opacity: 0.5;
@@ -530,6 +574,8 @@ export const ChoiceButton = styled.button<{
 
 // TitleBar
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const TitleBar = styled.div<{}>`
   height: ${constants.bottomHeight}px;
   padding: 0 ${(props) => 2 * props.theme.spacing}px;
@@ -547,6 +593,8 @@ export const TitleBar = styled.div<{}>`
 
 // TitleContainer
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const TitleContainer = styled.div<{}>`
   display: flex;
   align-items: center;
@@ -555,6 +603,8 @@ export const TitleContainer = styled.div<{}>`
 
 // Title
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const Title = styled.p<{}>`
   font-size: 16px;
   font-weight: bold;
@@ -564,6 +614,8 @@ export const Title = styled.p<{}>`
 
 // DiscreteButton
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const DiscreteLink = styled.a<{}>`
   color: ${(props) => props.theme.white};
   border: 0;
@@ -592,6 +644,8 @@ export const DiscreteLink = styled.a<{}>`
 
 // TitleIcon
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const TitleIcon = styled.img<{}>`
   width: 22px;
   height: 22px;
diff --git a/packages/chat-widget/src/ui/constants.ts b/packages/chat-widget/src/ui/constants.ts
index f6b8ba42..165fa246 100644
--- a/packages/chat-widget/src/ui/constants.ts
+++ b/packages/chat-widget/src/ui/constants.ts
@@ -1,4 +1,4 @@
-import { Theme } from "../theme";
+import { type Theme } from "../theme";
 
 export const bottomHeight = 60;
 
diff --git a/packages/chat-widget/src/utils.ts b/packages/chat-widget/src/utils.ts
index f80aab21..5fbe6cc9 100644
--- a/packages/chat-widget/src/utils.ts
+++ b/packages/chat-widget/src/utils.ts
@@ -14,6 +14,8 @@ const groupWhileHelper = <T>(
   const [head, ...tail] = list;
   const newGroup = (() => {
     const lastInGroup = currentGroup[currentGroup.length - 1];
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
     if (!lastInGroup) {
       return false;
     }
diff --git a/packages/eslint-config-nlx/documentation.js b/packages/eslint-config-nlx/documentation.js
new file mode 100644
index 00000000..076ec2f6
--- /dev/null
+++ b/packages/eslint-config-nlx/documentation.js
@@ -0,0 +1,19 @@
+/** @type {import('eslint').Linter.Config } */
+module.exports = {
+  extends: ["plugin:jsdoc/recommended-typescript-error"],
+  plugins: ["eslint-plugin-tsdoc"],
+  rules: {
+    "jsdoc/require-jsdoc": [
+      "error",
+      {
+        publicOnly: true,
+        // these ensure that documentation of various type script constructs is required. Will tweak as we go.
+        contexts: ["TSTypeAliasDeclaration","TSInterfaceDeclaration","TSMethodSignature","TSPropertySignature"]
+      }
+    ],
+    "jsdoc/check-tag-names": ["error", { definedTags: ["category", "hidden"] }],
+    "jsdoc/require-param": ["error", { checkDestructured: false }],
+    "jsdoc/check-param-names": ["error", { checkDestructured: false }],
+    "tsdoc/syntax": "error",
+  },
+};
diff --git a/packages/eslint-config-nlx/index.js b/packages/eslint-config-nlx/index.js
new file mode 100644
index 00000000..47c5bc6c
--- /dev/null
+++ b/packages/eslint-config-nlx/index.js
@@ -0,0 +1,36 @@
+/** @type {import('eslint').Linter.Config } */
+module.exports = {
+  env: {
+    browser: true,
+    es2021: true,
+  },
+  extends: [
+    "standard-with-typescript",
+    "plugin:react/recommended",
+    "prettier" // note: order matters. prettier being last overrides standard-with-typescript formatting
+  ],
+  overrides: [
+    {
+      env: {
+        node: true,
+      },
+      files: [".eslintrc.{js,cjs}"],
+      parserOptions: {
+        sourceType: "script",
+      },
+    },
+  ],
+  parserOptions: {
+    ecmaVersion: "latest",
+    sourceType: "module",
+  },
+  plugins: [
+    "react"
+  ],
+  ignorePatterns: ["dist", "node_modules", "vite-env.d.ts"],
+  settings: {
+    react: {
+      version: "detect",
+    },
+  },
+};
diff --git a/packages/eslint-config-nlx/package.json b/packages/eslint-config-nlx/package.json
new file mode 100644
index 00000000..5418eef6
--- /dev/null
+++ b/packages/eslint-config-nlx/package.json
@@ -0,0 +1,18 @@
+{
+  "name": "eslint-config-nlx",
+  "version": "0.0.0",
+  "private": true,
+  "peerDependencies": {
+    "eslint": "^8.57.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-config-standard-with-typescript": "^43.0.1",
+    "eslint-plugin-import": "^2.29.1",
+    "eslint-plugin-n": "^16.6.2",
+    "eslint-plugin-promise": "^6.1.1",
+    "eslint-plugin-react": "^7.33.2"
+  },
+  "devDependencies": {
+    "eslint-plugin-jsdoc": "^48.2.1",
+    "eslint-plugin-tsdoc": "^0.2.17"
+  }
+}
diff --git a/packages/voice-compass/.eslintrc.cjs b/packages/voice-compass/.eslintrc.cjs
new file mode 100644
index 00000000..9d09402d
--- /dev/null
+++ b/packages/voice-compass/.eslintrc.cjs
@@ -0,0 +1,5 @@
+/** @type {import('eslint').Linter.Config } */
+module.exports = {
+  root: true,
+  extends: ["nlx", "nlx/documentation"],
+};
diff --git a/packages/voice-compass/package.json b/packages/voice-compass/package.json
index da0e9f10..b318b7a3 100644
--- a/packages/voice-compass/package.json
+++ b/packages/voice-compass/package.json
@@ -11,9 +11,12 @@
   "scripts": {
     "build": "rm -rf lib && rollup -c",
     "docs": "typedoc",
-    "publish-docs": "npm run docs && concat-md --decrease-title-levels --dir-name-as-title docs/ > ../website/src/content/06-03-multimodal-api-reference.md",
+    "lint:check": "npx eslint src/ --ext .ts,.tsx,.js,.jsx",
+    "lint": "npx eslint src/ --ext .ts,.tsx,.js,.jsx --fix",
     "prepublish": "npm run build",
-    "test": "jest"
+    "publish-docs": "npm run docs && concat-md --decrease-title-levels --dir-name-as-title docs/ > ../website/src/content/06-03-multimodal-api-reference.md",
+    "test": "jest",
+    "tsc": "tsc"
   },
   "author": "Peter Szerzo <peter@nlx.ai>",
   "license": "MIT",
@@ -29,6 +32,7 @@
     "@types/node": "^11.15.11",
     "@types/ramda": "0.29.1",
     "concat-md": "^0.5.1",
+    "eslint-config-nlx": "*",
     "fast-check": "^3.16.0",
     "jest": "^29.7.0",
     "prettier": "^3.0.3",
@@ -37,6 +41,7 @@
     "ts-jest": "^29.1.2",
     "ts-node": "^10.9.2",
     "typedoc": "^0.25.12",
+    "typedoc-plugin-markdown": "^3.17.1",
     "typescript": "^5.2.2"
   },
   "dependencies": {
diff --git a/packages/voice-compass/src/index.ts b/packages/voice-compass/src/index.ts
index 78fc157a..9c81a713 100644
--- a/packages/voice-compass/src/index.ts
+++ b/packages/voice-compass/src/index.ts
@@ -2,7 +2,6 @@ import fetch from "isomorphic-fetch";
 
 /**
  * The starting point of the package. Call create to create a `VoiceCompass` client.
- *
  * @example
  * ```typescript
  *  const client = nlxai.voiceCompass.create({
@@ -17,11 +16,8 @@ import fetch from "isomorphic-fetch";
  *
  * client.sendStep("REPLACE_WITH_STEP_ID");
  * ```
- *
  * @category Setup
- *
- * @param options - the configuration object
- *
+ * @param options - configuration options for the client
  * @returns a Voice Compass client
  */
 export const create = ({
@@ -33,47 +29,47 @@ export const create = ({
   debug = false,
   dev = false,
 }: Config): Client => {
-  if (!conversationId) {
+  if (typeof conversationId !== "string" || conversationId.length === 0) {
     console.warn(
       'No conversation ID provided. Please call the Voice Compass client `create` method with a `conversationId` field extracted from the URL. Example code: `new URLSearchParams(window.location.search).get("cid")`',
     );
   }
-  const sendStep = (stepId: string, context?: Context) => {
-    if (!stepIdRegex.test(stepId)) {
-      throw new Error("Invalid stepId. It should be formatted as a UUID.");
-    }
+  return {
+    sendStep: async (stepId: string, context?: Context) => {
+      if (!stepIdRegex.test(stepId)) {
+        throw new Error("Invalid stepId. It should be formatted as a UUID.");
+      }
 
-    const payload = {
-      stepId,
-      context,
-      conversationId,
-      journeyId,
-      languageCode,
-    };
+      const payload = {
+        stepId,
+        context,
+        conversationId,
+        journeyId,
+        languageCode,
+      };
 
-    return fetch(`https://${dev ? "dev." : ""}mm.nlx.ai/v1/track`, {
-      method: "POST",
-      headers: {
-        "x-api-key": apiKey,
-        "x-nlx-id": workspaceId,
-        "Content-Type": "application/json",
-      },
-      body: JSON.stringify(payload),
-    })
-      .then(() => {
-        if (debug) {
-          console.info(`✓ step: ${stepId}`, payload);
-        }
+      await fetch(`https://${dev ? "dev." : ""}mm.nlx.ai/v1/track`, {
+        method: "POST",
+        headers: {
+          "x-api-key": apiKey,
+          "x-nlx-id": workspaceId,
+          "Content-Type": "application/json",
+        },
+        body: JSON.stringify(payload),
       })
-      .catch((err: Error) => {
-        if (debug) {
-          console.error(`× step: ${stepId}`, err, payload);
-        }
-        throw err;
-      });
+        .then(() => {
+          if (debug) {
+            console.info(`✓ step: ${stepId}`, payload);
+          }
+        })
+        .catch((err: Error) => {
+          if (debug) {
+            console.error(`× step: ${stepId}`, err, payload);
+          }
+          throw err;
+        });
+    },
   };
-
-  return { sendStep };
 };
 
 /**
@@ -83,7 +79,7 @@ export const create = ({
 export interface Client {
   /**
    *
-   * * @example
+   * @example
    * ```typescript
    *  const client = nlxai.voiceCompass.create({
    *  // hard-coded params
@@ -102,7 +98,6 @@ export interface Client {
    *
    *
    *   _Note: Must be a valid UUID_
-   *
    * @param context -  context to send back to the voice bot, for usage later in the intent.
    */
   sendStep: (stepId: string, context?: Context) => Promise<void>;
@@ -119,7 +114,7 @@ export type Context = Record<string, any>;
  * @category Setup
  */
 export interface Config {
-  /** * the API key generated for the journey.  **/
+  /** * the API key generated for the journey.  */
   apiKey: string;
   /** the ID of the journey.  */
   journeyId: string;
@@ -127,16 +122,18 @@ export interface Config {
   /** your workspace id */
   workspaceId: string;
 
-  /** the conversation id, passed from the active voice bot.
+  /**
+   * the conversation id, passed from the active voice bot.
    *
    * _Note: This must be dynamically set by the voice bot._
-   * */
+   */
   conversationId: string;
 
-  /** the user's language code.
+  /**
+   * the user's language code.
    *
    * In the browser may be fetched from `navigator.language`, or if the journey doesn't support multiple languages, can be hardcoded.
-   * */
+   */
   languageCode: string;
 
   /** set to true to help debug issues or errors. Defaults to false */
@@ -147,7 +144,8 @@ export interface Config {
 }
 
 /**
- * @internal @hidden
+ * @internal
+ * @hidden
  * this is exported so we can test it. Should be equivalent to a UUID v4 regex.
  */
 export const stepIdRegex =
diff --git a/packages/voice-compass/tsdoc.json b/packages/voice-compass/tsdoc.json
new file mode 100644
index 00000000..4358f3d0
--- /dev/null
+++ b/packages/voice-compass/tsdoc.json
@@ -0,0 +1,6 @@
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/tsdoc/v0/tsdoc.schema.json",
+  "extends": ["typedoc/tsdoc.json"],
+  "noStandardTags": false,
+  "tagDefinitions": []
+}
diff --git a/packages/voice-compass/typedoc.cjs b/packages/voice-compass/typedoc.cjs
index df927646..7247eb5c 100644
--- a/packages/voice-compass/typedoc.cjs
+++ b/packages/voice-compass/typedoc.cjs
@@ -7,6 +7,6 @@ module.exports = {
   treatWarningsAsErrors: true,
   treatValidationWarningsAsErrors: true,
   categoryOrder: ["Setup", "Client"],
-  plugin: ["typedoc-plugin-markdown"],
+  // plugin: ["typedoc-plugin-markdown"],
   readme: "none",
 };
diff --git a/packages/website/.eslintrc.js b/packages/website/.eslintrc.js
new file mode 100644
index 00000000..5889268a
--- /dev/null
+++ b/packages/website/.eslintrc.js
@@ -0,0 +1,5 @@
+/** @type {import('eslint').Linter.Config } */
+module.exports = {
+  root: true,
+  extends: ["nlx"],
+};
diff --git a/packages/website/package.json b/packages/website/package.json
index b1dca233..19ac5e6c 100644
--- a/packages/website/package.json
+++ b/packages/website/package.json
@@ -3,8 +3,11 @@
   "private": true,
   "version": "0.1.0",
   "scripts": {
+    "build": "tsc && vite build",
     "dev": "vite --force",
-    "build": "tsc && vite build"
+    "lint:check": "npx eslint src/ --ext .ts,.tsx,.js,.jsx,.mdx",
+    "lint": "npx eslint src/ --ext .ts,.tsx,.js,.jsx,.mdx --fix",
+    "tsc": "tsc"
   },
   "dependencies": {
     "@nlxai/chat-core": "*",
@@ -35,6 +38,7 @@
     "@vitejs/plugin-react": "^4.0.3",
     "autoprefixer": "^10.4.16",
     "esbuild": "^0.18.20",
+    "eslint-config-nlx": "*",
     "postcss": "^8.4.31",
     "tailwindcss": "^3.3.5",
     "typescript": "^5.0.2",
diff --git a/packages/website/src/components/ChatConfiguration.tsx b/packages/website/src/components/ChatConfiguration.tsx
index bcec0f13..794ca83b 100644
--- a/packages/website/src/components/ChatConfiguration.tsx
+++ b/packages/website/src/components/ChatConfiguration.tsx
@@ -7,8 +7,14 @@ import { RadioList } from "./RadioList";
 
 export const getInitialConfig = (): Config => {
   const searchParams = new URLSearchParams(window.location.search);
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
   const botUrl = searchParams.get("botUrl") || "";
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
   const apiKey = searchParams.get("apiKey") || "";
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
   const languageCode = searchParams.get("languageCode") || "en-US";
   return {
     botUrl,
@@ -109,6 +115,8 @@ export const ThemeEditor: FC<{
           value={theme.fontFamily}
           onChange={(ev: any) => {
             props.onChange({
+              // initial eslint integration
+              // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
               fontFamily: ev.target.value || defaultTheme.fontFamily,
             });
           }}
@@ -230,6 +238,8 @@ export const BehaviorEditor: FC<{
   );
 };
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const saveTheme = (theme: Partial<Theme>) => {
   localStorage.setItem("nlxchat-theme", JSON.stringify(theme));
 };
@@ -237,6 +247,8 @@ export const saveTheme = (theme: Partial<Theme>) => {
 export const retrieveTheme = (): Partial<Theme> | null => {
   try {
     const themeString = localStorage.getItem("nlxchat-theme");
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
     const theme = JSON.parse(themeString || "");
     if (typeof theme !== "object") {
       throw new Error("Invalid theme");
@@ -247,6 +259,8 @@ export const retrieveTheme = (): Partial<Theme> | null => {
   }
 };
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const saveTitleBar = (theme: TitleBar) => {
   localStorage.setItem("nlxchat-titleBar", JSON.stringify(theme));
 };
@@ -254,6 +268,8 @@ export const saveTitleBar = (theme: TitleBar) => {
 export const retrieveTitleBar = (): TitleBar | null => {
   try {
     const titleBarString = localStorage.getItem("nlxchat-titleBar");
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
     const titleBar = JSON.parse(titleBarString || "");
     if (typeof titleBar !== "object") {
       throw new Error("Invalid theme");
diff --git a/packages/website/src/components/CodeEditor.tsx b/packages/website/src/components/CodeEditor.tsx
index e07254f7..4e13afe4 100644
--- a/packages/website/src/components/CodeEditor.tsx
+++ b/packages/website/src/components/CodeEditor.tsx
@@ -1,6 +1,8 @@
 import { DownloadIcon } from "./Icons";
 import React, { type FC, useRef, useEffect } from "react";
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 const escapeForHighlightJs = (str: string) =>
   str
     .replace(/&/g, "&amp;")
diff --git a/packages/website/src/components/Hero.tsx b/packages/website/src/components/Hero.tsx
index ce7d6f77..0d52e9fa 100644
--- a/packages/website/src/components/Hero.tsx
+++ b/packages/website/src/components/Hero.tsx
@@ -5,6 +5,8 @@ import { FeedbackForm } from "../custom-components/FeedbackForm";
 import { Carousel, carouselExampleData } from "../custom-components/Carousel";
 import { InlineWidget } from "../components/InlineWidget";
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const Hero = () => {
   const location = useLocation();
   const pathname =
@@ -25,7 +27,7 @@ export const Hero = () => {
             <div className="relative">
               <p className="inline text-white font-display text-5xl">
                 SDK for rich conversational experiences powered by{" "}
-                <a href="https://nlx.ai" target="_blank">
+                <a href="https://nlx.ai" target="_blank" rel="noreferrer">
                   NLX
                 </a>
                 &reg;
diff --git a/packages/website/src/components/Icons.tsx b/packages/website/src/components/Icons.tsx
index bb4f1a62..9163a4ae 100644
--- a/packages/website/src/components/Icons.tsx
+++ b/packages/website/src/components/Icons.tsx
@@ -1,29 +1,39 @@
 import React, { type FC } from "react";
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const CloseIcon: FC<{}> = () => (
   <svg width="100%" height="100%" viewBox="0 0 24 24" fill="currentColor">
     <path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z" />
   </svg>
 );
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const GitHubIcon: FC<{}> = () => (
   <svg width="100%" height="100%" viewBox="0 0 24 24" fill="currentColor">
     <path d="M12 1.27a11 11 0 00-3.48 21.46c.55.09.73-.28.73-.55v-1.84c-3.03.64-3.67-1.46-3.67-1.46-.55-1.29-1.28-1.65-1.28-1.65-.92-.65.1-.65.1-.65 1.1 0 1.73 1.1 1.73 1.1.92 1.65 2.57 1.2 3.21.92a2 2 0 01.64-1.47c-2.47-.27-5.04-1.19-5.04-5.5 0-1.1.46-2.1 1.2-2.84a3.76 3.76 0 010-2.93s.91-.28 3.11 1.1c1.8-.49 3.7-.49 5.5 0 2.1-1.38 3.02-1.1 3.02-1.1a3.76 3.76 0 010 2.93c.83.74 1.2 1.74 1.2 2.94 0 4.21-2.57 5.13-5.04 5.4.45.37.82.92.82 2.02v3.03c0 .27.1.64.73.55A11 11 0 0012 1.27" />
   </svg>
 );
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const DownloadIcon: FC<{}> = () => (
   <svg width="100%" height="100%" viewBox="0 0 24 24" fill="currentColor">
     <path d="M5 20h14v-2H5v2zM19 9h-4V3H9v6H5l7 7 7-7z" />
   </svg>
 );
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const ContentCopyIcon: FC<{}> = () => (
   <svg width="100%" height="100%" viewBox="0 0 24 24" fill="currentColor">
     <path d="M16 1H4c-1.1 0-2 .9-2 2v14h2V3h12V1zm3 4H8c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h11c1.1 0 2-.9 2-2V7c0-1.1-.9-2-2-2zm0 16H8V7h11v14z" />
   </svg>
 );
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const CheckIcon: FC<{}> = () => (
   <svg width="100%" height="100%" viewBox="0 0 24 24" fill="currentColor">
     <path d="M9 16.17 4.83 12l-1.42 1.41L9 19 21 7l-1.41-1.41z" />
diff --git a/packages/website/src/components/InlineWidget.tsx b/packages/website/src/components/InlineWidget.tsx
index c273090a..ae2c78bd 100644
--- a/packages/website/src/components/InlineWidget.tsx
+++ b/packages/website/src/components/InlineWidget.tsx
@@ -12,6 +12,8 @@ export type Item =
   | { type: "bot"; message: string }
   | { type: "custom"; element: ReactNode };
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 const Loader: FC<{}> = () => (
   <div className="inline-flex items-center py-1 space-x-1">
     <div className="w-1.5 h-1.5 animate-bounce rounded-full bg-current"></div>
@@ -42,6 +44,8 @@ export const InlineWidget: FC<{
     };
   }, [setTick]);
 
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
   const displayedItems = props.animated
     ? props.items.slice(0, 1 + (tick % props.items.length))
     : props.items;
@@ -49,6 +53,8 @@ export const InlineWidget: FC<{
   const loader: "user" | "bot" | undefined =
     displayedItems.length === props.items.length
       ? undefined
+      // initial eslint integration
+      // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
       : last(last(displayedItems) || [])?.type === "user"
         ? "bot"
         : "user";
@@ -65,6 +71,8 @@ export const InlineWidget: FC<{
       const firstContentNode: Node | undefined = addedNodes[0];
       if (
         isFullyVisible.current &&
+        // initial eslint integration
+        // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
         firstContentNode &&
         firstContentNode instanceof HTMLElement
       ) {
@@ -75,6 +83,8 @@ export const InlineWidget: FC<{
       }
     };
     const observer = new MutationObserver(callback);
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
     if (messagesContainer.current) {
       observer.observe(messagesContainer.current, {
         childList: true,
@@ -88,6 +98,8 @@ export const InlineWidget: FC<{
   useEffect(() => {
     const observer = new IntersectionObserver(
       (event) => {
+        // initial eslint integration
+        // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
         if (event[0]) {
           isFullyVisible.current = event[0].intersectionRatio > 0.95;
         }
@@ -96,6 +108,8 @@ export const InlineWidget: FC<{
         threshold: 0.95,
       },
     );
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
     if (messagesContainer.current) {
       observer.observe(messagesContainer.current);
     }
@@ -107,6 +121,8 @@ export const InlineWidget: FC<{
   return (
     <div
       className={`rounded-xl max-w-sm max-h-[440px] shadow-lg overflow-hidden flex flex-col ${
+        // initial eslint integration
+        // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
         props.className || ""
       }`}
     >
@@ -120,11 +136,15 @@ export const InlineWidget: FC<{
         {displayedItems.map((items: Item[], index: number) => {
           return (
             <div key={index} className="space-y-2 flex flex-col">
+              {/* initial eslint integration */}
+              {/* eslint-disable-next-line array-callback-return */}
               {items.map((item, itemIndex) => {
                 if (item.type === "user") {
                   return (
                     <div
                       className={`w-fit self-end bg-blueMain text-white p-2 text-sm rounded-lg mx-4 ${
+                        // initial eslint integration
+                        // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
                         props.animated ? "animate-slideInFromRight" : ""
                       }`}
                       key={itemIndex}
@@ -137,6 +157,8 @@ export const InlineWidget: FC<{
                   return (
                     <div
                       className={`w-fit self-start bg-gray-100 p-2 text-sm rounded-lg mx-4 ${
+                        // initial eslint integration
+                        // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
                         props.animated ? "animate-slideInFromLeft" : ""
                       }`}
                       key={itemIndex}
@@ -149,6 +171,8 @@ export const InlineWidget: FC<{
                   return (
                     <div
                       className={`w-full ${
+                        // initial eslint integration
+                        // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
                         props.animated ? "animate-slideInFromLeft" : ""
                       }`}
                       key={itemIndex}
@@ -161,6 +185,8 @@ export const InlineWidget: FC<{
             </div>
           );
         })}
+        {/* initial eslint integration */}
+        {/* eslint-disable-next-line @typescript-eslint/strict-boolean-expressions */}
         {loader &&
           (loader === "user" ? (
             <div
diff --git a/packages/website/src/components/Logo.tsx b/packages/website/src/components/Logo.tsx
index 630cc8d6..704f418b 100644
--- a/packages/website/src/components/Logo.tsx
+++ b/packages/website/src/components/Logo.tsx
@@ -1,8 +1,12 @@
-import React, { FC } from "react";
+import React, { type FC } from "react";
 
 export const Logo: FC<{ size?: number }> = ({ size }) => (
   <svg
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
     width={size || 32}
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
     height={size || 32}
     viewBox="0 -5 24 24"
     fill="currentColor"
diff --git a/packages/website/src/components/MultimodalConfiguration.tsx b/packages/website/src/components/MultimodalConfiguration.tsx
index 6de0890a..268d6c2b 100644
--- a/packages/website/src/components/MultimodalConfiguration.tsx
+++ b/packages/website/src/components/MultimodalConfiguration.tsx
@@ -1,21 +1,21 @@
 import React, { type FC } from "react";
 import { Labeled, inputClass } from "./Ui";
 
-type HardCodedConfig = {
+interface HardCodedConfig {
   workspaceId: string;
   apiKey: string;
   journeyId: string;
   testStepId: string;
-};
+}
 
-type DynamicConfigAsStrings = {
+interface DynamicConfigAsStrings {
   languageCode: string;
   conversationId: string;
-};
-type DynamicConfigAsCode = {
+}
+interface DynamicConfigAsCode {
   languageCodeSnippet: string;
   conversationIdSnippet: string;
-};
+}
 
 export type Config = HardCodedConfig &
   (DynamicConfigAsCode | DynamicConfigAsStrings);
@@ -24,11 +24,23 @@ export type ConfigAsStrings = HardCodedConfig & DynamicConfigAsStrings;
 
 export const getInitialConfig = (): ConfigAsStrings => {
   const searchParams = new URLSearchParams(window.location.search);
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
   const workspaceId = searchParams.get("workspaceId") || "";
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
   const apiKey = searchParams.get("apiKey") || "";
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
   const languageCode = searchParams.get("languageCode") || "en-US";
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
   const journeyId = searchParams.get("journeyId") || "";
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
   const conversationId = searchParams.get("conversationId") || "";
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
   const testStepId = searchParams.get("testStepId") || "";
   return {
     workspaceId,
diff --git a/packages/website/src/components/Nav.tsx b/packages/website/src/components/Nav.tsx
index 97313cc4..4736a881 100644
--- a/packages/website/src/components/Nav.tsx
+++ b/packages/website/src/components/Nav.tsx
@@ -6,7 +6,7 @@ import { Logo } from "./Logo";
 
 const MenuListItem: FC<{
   heading: string;
-  items: { label: string; url: string }[];
+  items: Array<{ label: string; url: string }>;
 }> = (props) => {
   const location = useLocation();
   const pathname =
@@ -42,6 +42,8 @@ const MenuListItem: FC<{
   );
 };
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const Nav: FC<{}> = () => (
   <div className="hidden lg:relative lg:block lg:flex-none">
     <div className="absolute inset-y-0 right-0 w-[50vw] bg-gray-50"></div>
@@ -146,6 +148,8 @@ export const MobileNav: FC<{
         </div>
       </div>
     </div>,
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
     document.querySelector("#portal")!,
   );
 };
diff --git a/packages/website/src/components/NextPrevPage.tsx b/packages/website/src/components/NextPrevPage.tsx
index e9827b91..17985d37 100644
--- a/packages/website/src/components/NextPrevPage.tsx
+++ b/packages/website/src/components/NextPrevPage.tsx
@@ -1,6 +1,8 @@
 import React, { type FC } from "react";
 import { Link } from "react-router-dom";
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 const PrevArrow: FC<{}> = () => (
   <svg
     viewBox="0 0 16 16"
@@ -11,6 +13,8 @@ const PrevArrow: FC<{}> = () => (
   </svg>
 );
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 const NextArrow: FC<{}> = () => (
   <svg
     viewBox="0 0 16 16"
@@ -30,6 +34,8 @@ export const NextPrevPage: FC<{ prev?: LinkData; next?: LinkData }> = (
   props,
 ) => (
   <dl className="mt-12 flex border-t border-gray-200 pt-6">
+    {/* initial eslint integration */}
+    {/* eslint-disable-next-line @typescript-eslint/strict-boolean-expressions */}
     {props.prev && (
       <div>
         <dt className="font-display text-sm font-medium text-gray-800">
@@ -46,6 +52,8 @@ export const NextPrevPage: FC<{ prev?: LinkData; next?: LinkData }> = (
         </dd>
       </div>
     )}
+    {/* initial eslint integration */}
+    {/* eslint-disable-next-line @typescript-eslint/strict-boolean-expressions */}
     {props.next && (
       <div className="ml-auto text-right">
         <dt className="font-display text-sm font-medium text-gray-900">Next</dt>
diff --git a/packages/website/src/components/PageContent.tsx b/packages/website/src/components/PageContent.tsx
index 9d7df00b..63b920a1 100644
--- a/packages/website/src/components/PageContent.tsx
+++ b/packages/website/src/components/PageContent.tsx
@@ -15,10 +15,14 @@ const CopyToClipboardButton: FC<{ text: string; className?: string }> = ({
   return (
     <button
       className={`w-8 h-8 p-1.5 bg-slate-900 border border-slate-600 rounded-lg hover:bg-slate-800 ${
+        // initial eslint integration
+        // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
         className || ""
       }`}
       onClick={() => {
         setCopied(true);
+        // initial eslint integration
+        // eslint-disable-next-line @typescript-eslint/no-floating-promises
         navigator.clipboard.writeText(text);
         setTimeout(() => {
           setCopied(false);
@@ -36,6 +40,8 @@ export const Prose: FC<{ children: ReactNode; className?: string }> = ({
 }) => (
   <div
     className={`prose prose-slate max-w-none prose-headings:scroll-mt-28 prose-headings:font-display prose-headings:font-normal lg:prose-headings:scroll-mt-[8.5rem] prose-lead:text-slate-500 prose-a:font-medium prose-a:no-underline prose-a:shadow-[inset_0_-2px_0_0_var(--tw-prose-background,#fff),inset_0_calc(-1*(var(--tw-prose-underline-size,4px)+2px))_0_0_var(--tw-prose-underline,theme(colors.blue.300))] hover:prose-a:[--tw-prose-underline-size:6px]] prose-pre:rounded-xl prose-pre:bg-slate-900 prose-pre:shadow-lg ${
+      // initial eslint integration
+      // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
       className || ""
     }`}
   >
@@ -55,7 +61,11 @@ export const PageContent: FC<{ md: string }> = ({ md }) => (
           );
         },
         code(props) {
+          // initial eslint integration
+          // eslint-disable-next-line react/prop-types
           const { children, className, node, ...rest } = props;
+          // initial eslint integration
+          // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
           const match = /language-(\w+)/.exec(className || "");
           const lines = String(children).replace(/\n$/, "");
           return (
@@ -64,8 +74,12 @@ export const PageContent: FC<{ md: string }> = ({ md }) => (
                 text={lines}
                 className="absolute top-1.5 right-1.5 hidden group-hover:block"
               />
+              {/* initial eslint integration */}
+              {/* eslint-disable-next-line @typescript-eslint/strict-boolean-expressions */}
               {match ? (
                 <SyntaxHighlighter
+                  // initial eslint integration
+                  // eslint-disable-next-line react/no-children-prop
                   children={lines}
                   style={{}}
                   useInlineStyles={false}
diff --git a/packages/website/src/components/RadioList.tsx b/packages/website/src/components/RadioList.tsx
index 33fe27a6..dc569dcd 100644
--- a/packages/website/src/components/RadioList.tsx
+++ b/packages/website/src/components/RadioList.tsx
@@ -1,12 +1,14 @@
 import React, { type ReactNode } from "react";
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/no-unnecessary-type-constraint
 export const RadioList = <T extends unknown>({
   selected,
   options,
   onChange,
 }: {
   selected: T;
-  options: { id: string; value: T; label: string }[];
+  options: Array<{ id: string; value: T; label: string }>;
   onChange: (val: T) => void;
 }): ReactNode => {
   console.log(selected, options);
diff --git a/packages/website/src/content/01-01-getting-started.tsx b/packages/website/src/content/01-01-getting-started.tsx
index 547a46d2..3b2be48d 100644
--- a/packages/website/src/content/01-01-getting-started.tsx
+++ b/packages/website/src/content/01-01-getting-started.tsx
@@ -12,6 +12,8 @@ This is the official JavaScript SDK to communicate with conversational bots crea
 * [@nlxai/voice-compass](${packageUrls.voiceCompass}): multimodal capabilities.
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const GettingStarted = () => {
   return (
     <>
diff --git a/packages/website/src/content/01-02-installation.tsx b/packages/website/src/content/01-02-installation.tsx
index 0f80ba6d..05d469b1 100644
--- a/packages/website/src/content/01-02-installation.tsx
+++ b/packages/website/src/content/01-02-installation.tsx
@@ -51,6 +51,8 @@ npm install @nlxai/voice-compass
 ~~~
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const Installation = () => {
   return (
     <>
diff --git a/packages/website/src/content/02-01-web-widget-setup.tsx b/packages/website/src/content/02-01-web-widget-setup.tsx
index 98ee9327..b6833ca0 100644
--- a/packages/website/src/content/02-01-web-widget-setup.tsx
+++ b/packages/website/src/content/02-01-web-widget-setup.tsx
@@ -20,6 +20,8 @@ In this snippet, the script is deferred in order to reduce impact on page speed.
   - \`logo\`: the static URL of a logo image that appears left of the title.
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const WebWidgetSetup = () => {
   return (
     <>
diff --git a/packages/website/src/content/02-02-web-widget-theming.tsx b/packages/website/src/content/02-02-web-widget-theming.tsx
index 2b5f0709..206c4591 100644
--- a/packages/website/src/content/02-02-web-widget-theming.tsx
+++ b/packages/website/src/content/02-02-web-widget-theming.tsx
@@ -14,6 +14,8 @@ The chat widget exposes a number of style theme parameters that can be customize
 - \`chatWindowMaxHeight\`: the maximum height of the chat box, relevant for large screens.
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const WebWidgetTheming = () => {
   return (
     <>
diff --git a/packages/website/src/content/02-03-web-widget-custom-behaviors.tsx b/packages/website/src/content/02-03-web-widget-custom-behaviors.tsx
index c6935a99..928a14cf 100644
--- a/packages/website/src/content/02-03-web-widget-custom-behaviors.tsx
+++ b/packages/website/src/content/02-03-web-widget-custom-behaviors.tsx
@@ -8,6 +8,8 @@ export const content = `
 The widget can be configured to handle a number of custom behaviors. Select one from below and see how the code snippet changes:
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const codeContent = (behavior: Behavior) => `
 ~~~html
 ${setupSnippet({
@@ -18,6 +20,8 @@ ${setupSnippet({
 ~~~
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const WebWidgetCustomBehaviors = () => {
   const [behavior, setBehavior] = useState<Behavior>(Behavior.Simple);
   return (
diff --git a/packages/website/src/content/02-04-web-widget-try-live.tsx b/packages/website/src/content/02-04-web-widget-try-live.tsx
index fd0b7c16..fa5248d7 100644
--- a/packages/website/src/content/02-04-web-widget-try-live.tsx
+++ b/packages/website/src/content/02-04-web-widget-try-live.tsx
@@ -35,6 +35,8 @@ export const snippetContent = ({
   titleBar: TitleBar;
   theme: Partial<Theme>;
   behavior: Behavior;
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 }) => `
 
 ### Setup snippet
@@ -44,10 +46,14 @@ ${setupSnippet({ config, titleBar, theme, behavior })}
 \`\`\`
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const WebWidgetTryLive = () => {
   const [config, setConfig] = useState<Config>(getInitialConfig());
 
   const [theme, setTheme] = useState<Partial<Theme>>(
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
     retrieveTheme() || defaultTheme,
   );
 
@@ -56,6 +62,8 @@ export const WebWidgetTryLive = () => {
   }, [theme]);
 
   const [titleBar, setTitleBar] = useState<TitleBar>(
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
     retrieveTitleBar() || {
       title: "Support",
     },
diff --git a/packages/website/src/content/03-01-web-widget-components-getting-started.tsx b/packages/website/src/content/03-01-web-widget-components-getting-started.tsx
index f6c4e96b..c7535acd 100644
--- a/packages/website/src/content/03-01-web-widget-components-getting-started.tsx
+++ b/packages/website/src/content/03-01-web-widget-components-getting-started.tsx
@@ -19,6 +19,8 @@ ${setupSnippet({
 ~~~
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const WebWidgetComponentsGettingStarted = () => {
   return (
     <>
diff --git a/packages/website/src/content/03-03-disclaimer.tsx b/packages/website/src/content/03-03-disclaimer.tsx
index 204e93a4..fadd3f3b 100644
--- a/packages/website/src/content/03-03-disclaimer.tsx
+++ b/packages/website/src/content/03-03-disclaimer.tsx
@@ -14,6 +14,8 @@ ${disclaimerSnippet}
 ~~~
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const WebWidgetComponentsDisclaimer = () => {
   return (
     <>
diff --git a/packages/website/src/content/03-04-carousel.tsx b/packages/website/src/content/03-04-carousel.tsx
index 3e42a5ca..98ee4727 100644
--- a/packages/website/src/content/03-04-carousel.tsx
+++ b/packages/website/src/content/03-04-carousel.tsx
@@ -14,6 +14,8 @@ ${carouselSnippet}
 ~~~
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const WebWidgetComponentsCarousel = () => {
   return (
     <>
diff --git a/packages/website/src/content/03-05-feedback-form.tsx b/packages/website/src/content/03-05-feedback-form.tsx
index b7f58830..13d49647 100644
--- a/packages/website/src/content/03-05-feedback-form.tsx
+++ b/packages/website/src/content/03-05-feedback-form.tsx
@@ -14,6 +14,8 @@ ${feedbackFormSnippet}
 ~~~
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const WebWidgetComponentsFeedbackForm = () => {
   return (
     <>
diff --git a/packages/website/src/content/03-06-datepicker.tsx b/packages/website/src/content/03-06-datepicker.tsx
index a50af2e5..8c98bb98 100644
--- a/packages/website/src/content/03-06-datepicker.tsx
+++ b/packages/website/src/content/03-06-datepicker.tsx
@@ -2,7 +2,7 @@ import React, { useState } from "react";
 import { PageTitle } from "../components/PageTitle";
 import { PageContent } from "../components/PageContent";
 import { DatePicker } from "../custom-components/DatePicker";
-import { InlineWidget, Item } from "../components/InlineWidget";
+import { InlineWidget, type Item } from "../components/InlineWidget";
 import { datePickerSnippet } from "../snippets";
 
 export const content = `
@@ -13,6 +13,8 @@ ${datePickerSnippet}
 ~~~
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const WebWidgetComponentsDatePicker = () => {
   const [submitted, setSubmitted] = useState(false);
   const [date, setDate] = useState<Date | null>(null);
diff --git a/packages/website/src/content/03-07-file-upload.tsx b/packages/website/src/content/03-07-file-upload.tsx
index f83019ad..81add59c 100644
--- a/packages/website/src/content/03-07-file-upload.tsx
+++ b/packages/website/src/content/03-07-file-upload.tsx
@@ -2,7 +2,7 @@ import React, { useState } from "react";
 import { PageTitle } from "../components/PageTitle";
 import { PageContent } from "../components/PageContent";
 import { FileUpload } from "../custom-components/FileUpload";
-import { InlineWidget, Item } from "../components/InlineWidget";
+import { InlineWidget, type Item } from "../components/InlineWidget";
 import { fileUploadSnippet } from "../snippets";
 
 export const content = `
@@ -13,6 +13,8 @@ ${fileUploadSnippet}
 ~~~
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const WebWidgetComponentsFileUpload = () => {
   const [uploaded, setUploaded] = useState(false);
   const [fileName, setFileName] = useState<string | null>(null);
diff --git a/packages/website/src/content/03-08-address-input.tsx b/packages/website/src/content/03-08-address-input.tsx
index 2cfc3919..5370e162 100644
--- a/packages/website/src/content/03-08-address-input.tsx
+++ b/packages/website/src/content/03-08-address-input.tsx
@@ -1,7 +1,7 @@
 import React, { useState } from "react";
 import { PageTitle } from "../components/PageTitle";
 import { PageContent } from "../components/PageContent";
-import { InlineWidget, Item } from "../components/InlineWidget";
+import { InlineWidget, type Item } from "../components/InlineWidget";
 import { addressInputSnippet, mapSnippet } from "../snippets";
 import AddressInput from "../custom-components/Address";
 
@@ -15,6 +15,8 @@ ${addressInputSnippet}
 ~~~
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const WebWidgetComponentsAddressInput = () => {
   const [formattedAddress, setFormattedAddress] = useState<string>("");
   const [submitted, setSubmitted] = useState(false);
@@ -26,9 +28,9 @@ export const WebWidgetComponentsAddressInput = () => {
         element: (
           <AddressInput
             address={formattedAddress}
-            onAddressChange={(address: string) => setFormattedAddress(address)}
+            onAddressChange={(address: string) => { setFormattedAddress(address); }}
             submitted={submitted}
-            onSubmit={() => setSubmitted(true)}
+            onSubmit={() => { setSubmitted(true); }}
           />
         ),
       },
diff --git a/packages/website/src/content/03-09-video-player.tsx b/packages/website/src/content/03-09-video-player.tsx
index 68228d88..77395a6e 100644
--- a/packages/website/src/content/03-09-video-player.tsx
+++ b/packages/website/src/content/03-09-video-player.tsx
@@ -1,7 +1,7 @@
 import React from "react";
 import { PageTitle } from "../components/PageTitle";
 import { PageContent } from "../components/PageContent";
-import { InlineWidget, Item } from "../components/InlineWidget";
+import { InlineWidget, type Item } from "../components/InlineWidget";
 import { disclaimerSnippet } from "../snippets";
 import VideoPlayer from "../custom-components/VideoPlayer";
 
@@ -13,6 +13,8 @@ ${disclaimerSnippet}
 ~~~
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const WebWidgetComponentsVideoPlayer = () => {
   const items: Item[][] = [
     [
diff --git a/packages/website/src/content/03-10-secure-input.tsx b/packages/website/src/content/03-10-secure-input.tsx
index 3a0ecc49..d8c8622f 100644
--- a/packages/website/src/content/03-10-secure-input.tsx
+++ b/packages/website/src/content/03-10-secure-input.tsx
@@ -1,7 +1,7 @@
 import React, { useState } from "react";
 import { PageTitle } from "../components/PageTitle";
 import { PageContent } from "../components/PageContent";
-import { InlineWidget, Item } from "../components/InlineWidget";
+import { InlineWidget, type Item } from "../components/InlineWidget";
 import { disclaimerSnippet } from "../snippets";
 import SecureInput from "../custom-components/SecureInput";
 
@@ -13,7 +13,11 @@ ${disclaimerSnippet}
 ~~~
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const WebWidgetComponentsSecureInput = () => {
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
   const [submitted, setSubmitted] = useState(false);
 
   const items: Item[][] = [
diff --git a/packages/website/src/content/04-01-custom-widgets-getting-started.tsx b/packages/website/src/content/04-01-custom-widgets-getting-started.tsx
index d5374989..768ab210 100644
--- a/packages/website/src/content/04-01-custom-widgets-getting-started.tsx
+++ b/packages/website/src/content/04-01-custom-widgets-getting-started.tsx
@@ -8,6 +8,8 @@ The [@nlxai/chat-react]() and [@nlxai/chat-preact]() packages expose a complete
 The [@nlxai/chat-core]() framework-agnostic package is available for widget authors working in other frameworks.
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const CustomWidgetsGettingStarted = () => {
   return (
     <>
diff --git a/packages/website/src/content/04-02-custom-widgets-react.tsx b/packages/website/src/content/04-02-custom-widgets-react.tsx
index 20313f45..3e3f1531 100644
--- a/packages/website/src/content/04-02-custom-widgets-react.tsx
+++ b/packages/website/src/content/04-02-custom-widgets-react.tsx
@@ -17,6 +17,8 @@ ${customWidgetSnippet}
 ~~~
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const CustomWidgetsReact = () => {
   return (
     <>
diff --git a/packages/website/src/content/04-03-custom-widgets-other.tsx b/packages/website/src/content/04-03-custom-widgets-other.tsx
index 6c0377b0..710547f6 100644
--- a/packages/website/src/content/04-03-custom-widgets-other.tsx
+++ b/packages/website/src/content/04-03-custom-widgets-other.tsx
@@ -8,6 +8,8 @@ export const content = `
 If you are using a different frontend framework, you can easily integrate the [@nlxai/chat-core](${packageUrls.chatCore}) package covered in the next chapter to build a custom widget. In fact, the [React](${packageUrls.chatReact}) and [Preact](${packageUrls.chatReact}) packages are both under 100 lines of TypeScript.
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const CustomWidgetsOther = () => {
   return (
     <>
diff --git a/packages/website/src/content/05-01-headless-getting-started.tsx b/packages/website/src/content/05-01-headless-getting-started.tsx
index 145c1fd5..0b18e5cd 100644
--- a/packages/website/src/content/05-01-headless-getting-started.tsx
+++ b/packages/website/src/content/05-01-headless-getting-started.tsx
@@ -10,6 +10,8 @@ This package can be used to:
 - communicate with a bot on a Node.js server, passing along responses to a third-party chat system.
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const HeadlessGettingStarted = () => {
   return (
     <>
diff --git a/packages/website/src/content/05-02-headless-api-reference.tsx b/packages/website/src/content/05-02-headless-api-reference.tsx
index 24bba893..89df9d9a 100644
--- a/packages/website/src/content/05-02-headless-api-reference.tsx
+++ b/packages/website/src/content/05-02-headless-api-reference.tsx
@@ -51,6 +51,8 @@ Remove all subscriptions.
 Reset the conversation. This makes sure that information previously collected by your bot will not affect the logic of the conversation any longer.
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const HeadlessApi = () => {
   return (
     <>
diff --git a/packages/website/src/content/06-01-multimodal-getting-started.tsx b/packages/website/src/content/06-01-multimodal-getting-started.tsx
index a3701620..0ae2b96c 100644
--- a/packages/website/src/content/06-01-multimodal-getting-started.tsx
+++ b/packages/website/src/content/06-01-multimodal-getting-started.tsx
@@ -43,6 +43,8 @@ ${voiceCompassSetupSnippet({ environment: Environment.Bundle })}
 [journey]: <>
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const MultimodalGettingStarted = () => {
   return (
     <>
diff --git a/packages/website/src/content/06-02-multimodal-usage.tsx b/packages/website/src/content/06-02-multimodal-usage.tsx
index 61ab88c5..5ef57032 100644
--- a/packages/website/src/content/06-02-multimodal-usage.tsx
+++ b/packages/website/src/content/06-02-multimodal-usage.tsx
@@ -39,12 +39,16 @@ enum Usage {
 }
 
 function assertNever(x: never): never {
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/restrict-plus-operands
   throw new Error("Unexpected object: " + x);
 }
 
 function getUsageFrom(usageFrom: Usage): string {
   const persitanceCodeSample = (
     usageFrom: Usage.WithPersistanceBundled | Usage.WithPersitanceHTML,
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
   ) => {
     const environment =
       usageFrom === Usage.WithPersitanceHTML
@@ -59,7 +63,7 @@ if(conversationId != null) {
 }
 
 ${voiceCompassSnippet({
-  environment: environment,
+  environment,
   config: {
     conversationIdSnippet: "conversationId",
     languageCodeSnippet: "navigator.language",
@@ -140,6 +144,8 @@ ${voiceCompassSetupSnippet({ environment: Environment.Node })}
   }
 }
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const MultimodalUsage = () => {
   const [usageFrom, setUsageFrom] = useState<Usage>(Usage.SimpleHTML);
   return (
diff --git a/packages/website/src/content/06-03-multimodal-api-reference.tsx b/packages/website/src/content/06-03-multimodal-api-reference.tsx
index b982bea8..91b90ac6 100644
--- a/packages/website/src/content/06-03-multimodal-api-reference.tsx
+++ b/packages/website/src/content/06-03-multimodal-api-reference.tsx
@@ -3,6 +3,8 @@ import { PageTitle } from "../components/PageTitle";
 import { PageContent } from "../components/PageContent";
 import content from "./06-03-multimodal-api-reference.md?raw";
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const MultimodalApiReference = () => {
   return (
     <>
diff --git a/packages/website/src/content/06-04-multimodal-try-live.tsx b/packages/website/src/content/06-04-multimodal-try-live.tsx
index d5bb4615..86a7b1be 100644
--- a/packages/website/src/content/06-04-multimodal-try-live.tsx
+++ b/packages/website/src/content/06-04-multimodal-try-live.tsx
@@ -5,7 +5,7 @@ import {
   type Config,
   getInitialConfig,
   ConfigEditor,
-  ConfigAsStrings,
+  type ConfigAsStrings,
 } from "../components/MultimodalConfiguration";
 import { Note } from "../components/Note";
 import { voiceCompassSetupSnippet, Environment } from "../snippets";
@@ -14,6 +14,8 @@ export const content = `
 You can try your journeys directly on this configuration page.
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const snippetContent = (config: Config) => `
 
 ### Setup snippet
@@ -23,6 +25,8 @@ ${voiceCompassSetupSnippet({ config, environment: Environment.Html })}
 ~~~
 `;
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const MultimodalTryLive = () => {
   const [config, setConfig] = useState<ConfigAsStrings>(getInitialConfig());
 
diff --git a/packages/website/src/custom-components/Address.tsx b/packages/website/src/custom-components/Address.tsx
index e0dcc0d2..d7acd33f 100644
--- a/packages/website/src/custom-components/Address.tsx
+++ b/packages/website/src/custom-components/Address.tsx
@@ -1,4 +1,4 @@
-import React, { useEffect, useState, useRef, FC } from "react";
+import React, { useEffect, useState, useRef, type FC } from "react";
 
 import "./Address.css";
 
@@ -12,6 +12,8 @@ const Map: React.FC<MapProps> = ({ lat, lng, className }) => {
   const mapRef = useRef<HTMLDivElement>(null);
 
   useEffect(() => {
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
     if (mapRef.current) {
       const map = new (window as any).google.maps.Map(mapRef.current, {
         center: { lat, lng },
@@ -24,8 +26,10 @@ const Map: React.FC<MapProps> = ({ lat, lng, className }) => {
         fullscreenControl: true,
       });
 
+      // initial eslint integration
+      // eslint-disable-next-line no-new
       new (window as any).google.maps.Marker({
-        map: map,
+        map,
         position: { lat, lng },
       });
     }
@@ -35,10 +39,10 @@ const Map: React.FC<MapProps> = ({ lat, lng, className }) => {
 };
 
 const AddressInput: FC<{
-  onAddressChange(address: string): void;
+  onAddressChange: (address: string) => void;
   address: string;
   submitted: boolean;
-  onSubmit(): void;
+  onSubmit: () => void;
 }> = ({ onAddressChange, address, onSubmit, submitted }) => {
   const [coordinates, setCoordinates] = useState<{
     lat: number;
@@ -48,7 +52,11 @@ const AddressInput: FC<{
   const [isGoogleMapsLoaded, setIsGoogleMapsLoaded] = useState(false);
 
   useEffect(() => {
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
     const loadGoogleMapsScript = () => {
+      // initial eslint integration
+      // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
       if ((window as any).google) {
         return;
       }
@@ -60,7 +68,7 @@ const AddressInput: FC<{
       }&libraries=places`;
       script.async = true;
       script.defer = true;
-      script.onload = () => setIsGoogleMapsLoaded(true);
+      script.onload = () => { setIsGoogleMapsLoaded(true); };
       document.head.appendChild(script);
     };
 
@@ -68,7 +76,11 @@ const AddressInput: FC<{
   }, []);
 
   useEffect(() => {
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
     const initializeAutocomplete = () => {
+      // initial eslint integration
+      // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
       if (!(window as any).google || !textareaRef.current) return;
 
       const autocomplete = new (window as any).google.maps.places.Autocomplete(
@@ -84,26 +96,40 @@ const AddressInput: FC<{
         let city = "";
         let state = "";
         let postalCode = "";
+        // initial eslint integration
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
         let country = "";
 
         addressComponents.forEach((component: any) => {
           const types = component.types;
           const value = component.long_name;
 
+          // initial eslint integration
+          // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
           if (types.includes("street_number") || types.includes("route")) {
             street += `${value} `;
+          // initial eslint integration
+          // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
           } else if (types.includes("locality")) {
             city = value;
+          // initial eslint integration
+          // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
           } else if (types.includes("administrative_area_level_1")) {
             state = value;
+          // initial eslint integration
+          // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
           } else if (types.includes("postal_code")) {
             postalCode = value;
+          // initial eslint integration
+          // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
           } else if (types.includes("country")) {
             country = value;
           }
         });
 
         const location = place.geometry?.location;
+        // initial eslint integration
+        // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
         if (location) {
           setCoordinates({ lat: location.lat(), lng: location.lng() });
         }
@@ -127,11 +153,13 @@ const AddressInput: FC<{
       <textarea
         ref={textareaRef}
         value={address}
-        onChange={(e) => onAddressChange(e.target.value)}
+        onChange={(e) => { onAddressChange(e.target.value); }}
         placeholder="Enter address here"
         rows={5}
         className="address-textarea"
       />
+      {/* initial eslint integration */}
+      {/* eslint-disable-next-line @typescript-eslint/strict-boolean-expressions */}
       {coordinates && (
         <Map
           className="map-container"
@@ -139,6 +167,8 @@ const AddressInput: FC<{
           lng={coordinates.lng}
         />
       )}
+      {/* initial eslint integration */}
+      {/* eslint-disable-next-line @typescript-eslint/strict-boolean-expressions */}
       <button disabled={!coordinates || submitted} type="submit">
         Submit
       </button>
diff --git a/packages/website/src/custom-components/Carousel.tsx b/packages/website/src/custom-components/Carousel.tsx
index c53a53b4..9590cb25 100644
--- a/packages/website/src/custom-components/Carousel.tsx
+++ b/packages/website/src/custom-components/Carousel.tsx
@@ -1,5 +1,5 @@
 import "./Carousel.css";
-import { createElement, FC, useState } from "react";
+import { createElement, type FC, useState } from "react";
 import htm from "htm";
 
 const html = htm.bind(createElement);
diff --git a/packages/website/src/custom-components/DatePicker.tsx b/packages/website/src/custom-components/DatePicker.tsx
index 9b87ebf2..bd4db4b7 100644
--- a/packages/website/src/custom-components/DatePicker.tsx
+++ b/packages/website/src/custom-components/DatePicker.tsx
@@ -16,6 +16,8 @@ export const DatePicker: FC<{
       weekStart: 1, // Monday
     });
     datepicker.setDate(new Date());
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
     setDatepicker(datepicker);
   }, []);
 
@@ -26,6 +28,8 @@ export const DatePicker: FC<{
         ev.preventDefault();
 
         const date = (datepicker as any).getDate();
+        // initial eslint integration
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
         onSubmit(date);
 
         (datepicker as any).setDate({ clear: true });
diff --git a/packages/website/src/custom-components/Disclaimer.tsx b/packages/website/src/custom-components/Disclaimer.tsx
index d67d9a9a..a949d2d5 100644
--- a/packages/website/src/custom-components/Disclaimer.tsx
+++ b/packages/website/src/custom-components/Disclaimer.tsx
@@ -4,6 +4,8 @@ import htm from "htm";
 
 const html = htm.bind(createElement);
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const Disclaimer = () => {
   const [status, setStatus] = useState<"pending" | "accepted" | "denied">(
     "pending"
diff --git a/packages/website/src/custom-components/FeedbackForm.tsx b/packages/website/src/custom-components/FeedbackForm.tsx
index 7ddcddd6..5cb78a7f 100644
--- a/packages/website/src/custom-components/FeedbackForm.tsx
+++ b/packages/website/src/custom-components/FeedbackForm.tsx
@@ -5,6 +5,8 @@ import { useConversationHandler } from "@nlxai/chat-widget";
 
 const html = htm.bind(createElement);
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 export const FeedbackForm = () => {
   const handler = useConversationHandler();
   const [firstName, setFirstName] = useState("");
@@ -34,6 +36,8 @@ export const FeedbackForm = () => {
         disabled=${submitted}
         value=${firstName}
         onInput=${(ev: any) => {
+          // initial eslint integration
+          // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
           setFirstName(ev.target.value);
         }}
       />
@@ -43,6 +47,8 @@ export const FeedbackForm = () => {
         disabled=${submitted}
         value=${lastName}
         onInput=${(ev: any) => {
+          // initial eslint integration
+          // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
           setLastName(ev.target.value);
         }}
       />
@@ -53,6 +59,8 @@ export const FeedbackForm = () => {
         disabled=${submitted}
         value=${email}
         onInput=${(ev: any) => {
+          // initial eslint integration
+          // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
           setEmail(ev.target.value);
         }}
       />
@@ -62,6 +70,8 @@ export const FeedbackForm = () => {
         disabled=${submitted}
         value=${feedback}
         onInput=${(ev: any) => {
+          // initial eslint integration
+          // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
           setFeedback(ev.target.value);
         }}
       />
diff --git a/packages/website/src/custom-components/FileUpload.tsx b/packages/website/src/custom-components/FileUpload.tsx
index e9c85d1a..e4c07b0b 100644
--- a/packages/website/src/custom-components/FileUpload.tsx
+++ b/packages/website/src/custom-components/FileUpload.tsx
@@ -1,6 +1,6 @@
 import "./FileUpload.css";
 import uploadIcon from "./upload.png";
-import React, { type FC, useState, DragEvent } from "react";
+import React, { type FC, useState, type DragEvent } from "react";
 
 interface CircularProgressBarProps {
   progress: number;
@@ -55,6 +55,8 @@ export const FileUpload: FC<{
   const [uploadProgress, setUploadProgress] = useState<number>(0);
   const [dragOver, setDragOver] = useState<boolean>(false);
 
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
   const uploadFile = (file: File) => {
     const uploadTime = 2000;
 
@@ -71,27 +73,41 @@ export const FileUpload: FC<{
     }, uploadTime / 10);
   };
 
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
   const handleFileChange = (e: React.ChangeEvent<HTMLInputElement>) => {
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
     const file = e.target.files ? e.target.files[0] : null;
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
     if (file) {
       setSelectedFile(file);
       uploadFile(file);
     }
   };
 
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
   const handleDragOver = (e: DragEvent<HTMLDivElement>) => {
     e.preventDefault();
     setDragOver(true);
   };
 
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
   const handleDragLeave = (e: DragEvent<HTMLDivElement>) => {
     e.preventDefault();
     setDragOver(false);
   };
 
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
   const handleDrop = (e: DragEvent<HTMLDivElement>) => {
     e.preventDefault();
     setDragOver(false);
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-optional-chain
     if (e.dataTransfer.files && e.dataTransfer.files.length) {
       uploadFile(e.dataTransfer.files[0]);
     }
diff --git a/packages/website/src/custom-components/Payment.tsx b/packages/website/src/custom-components/Payment.tsx
index 3b4e160f..12d1f30c 100644
--- a/packages/website/src/custom-components/Payment.tsx
+++ b/packages/website/src/custom-components/Payment.tsx
@@ -1,6 +1,8 @@
 import "./Payment.css";
 import React, { type FC } from "react";
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const Payment: FC<{}> = () => {
   return <p>TBD payment</p>;
 };
diff --git a/packages/website/src/custom-components/SecureInput.tsx b/packages/website/src/custom-components/SecureInput.tsx
index 22e3dd37..ae56e5b6 100644
--- a/packages/website/src/custom-components/SecureInput.tsx
+++ b/packages/website/src/custom-components/SecureInput.tsx
@@ -1,4 +1,4 @@
-import React, { useState, ChangeEvent, FormEvent } from "react";
+import React, { useState, type ChangeEvent, type FormEvent } from "react";
 import "./SecureInput.css";
 import checkmarkIcon from "./checkmark.svg";
 
@@ -8,14 +8,20 @@ const SecureInput: React.FC = () => {
   const [isLoading, setIsLoading] = useState<boolean>(false);
   const [isSuccess, setIsSuccess] = useState<boolean>(false);
 
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
   const handleEmailChange = (event: ChangeEvent<HTMLInputElement>) => {
     setEmail(event.target.value);
   };
 
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
   const handlePasswordChange = (event: ChangeEvent<HTMLInputElement>) => {
     setPassword(event.target.value);
   };
 
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
   const handleSubmit = async (event: FormEvent<HTMLFormElement>) => {
     event.preventDefault();
     setIsLoading(true);
@@ -40,6 +46,8 @@ const SecureInput: React.FC = () => {
 
   return (
     <div className="form-container">
+      {/* initial eslint integration */}
+      {/* eslint-disable-next-line @typescript-eslint/no-misused-promises */}
       <form onSubmit={handleSubmit}>
         <input
           type="email"
diff --git a/packages/website/src/main.tsx b/packages/website/src/main.tsx
index 7ee4bcf7..6a351d86 100644
--- a/packages/website/src/main.tsx
+++ b/packages/website/src/main.tsx
@@ -7,6 +7,8 @@ import { Hero } from "./components/Hero";
 import { Nav, MobileNav } from "./components/Nav";
 import { ContentRoutes } from "./routes";
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 const App: FC<{}> = () => {
   const [mobileMenuExpanded, setMobileMenuExpanded] = useState<boolean>(false);
 
diff --git a/packages/website/src/routes.tsx b/packages/website/src/routes.tsx
index 76ed2881..ae7f81b1 100644
--- a/packages/website/src/routes.tsx
+++ b/packages/website/src/routes.tsx
@@ -33,20 +33,20 @@ import { MultimodalUsage } from "./content/06-02-multimodal-usage";
 import { MultimodalApiReference } from "./content/06-03-multimodal-api-reference";
 import { MultimodalTryLive } from "./content/06-04-multimodal-try-live";
 
-type Item = {
+interface Item {
   label: string;
   url: string;
   element: JSX.Element;
-};
+}
 
 function sortByLabel(items: Item[]): Item[] {
   return items.sort((a, b) => a.label.localeCompare(b.label));
 }
 
-export const routes: {
+export const routes: Array<{
   heading: string;
   items: Item[];
-}[] = [
+}> = [
   {
     heading: "Introduction",
     items: [
@@ -197,6 +197,8 @@ export const routes: {
   },
 ];
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/ban-types
 export const ContentRoutes: FC<{}> = () => {
   const flattenedRoutes = flatten(
     routes.map((r) => r.items.map((item) => ({ ...item, heading: r.heading }))),
@@ -214,12 +216,16 @@ export const ContentRoutes: FC<{}> = () => {
                 {element}
                 <NextPrevPage
                   prev={
+                    // initial eslint integration
+                    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
                     prev && {
                       label: `${prev.heading}: ${prev.label}`,
                       url: prev.url,
                     }
                   }
                   next={
+                    // initial eslint integration
+                    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
                     next && {
                       label: `${next.heading}: ${next.label}`,
                       url: next.url,
diff --git a/packages/website/src/snippets.ts b/packages/website/src/snippets.ts
index f236cb26..ebe4da26 100644
--- a/packages/website/src/snippets.ts
+++ b/packages/website/src/snippets.ts
@@ -18,6 +18,8 @@ export enum Environment {
   Node,
 }
 
+// initial eslint integration
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 const indentBy = (indendStr: string, str: string) =>
   str
     .split("\n")
@@ -58,6 +60,8 @@ export const setupSnippet = ({
   theme?: Partial<Theme>;
   behavior?: Behavior;
   customModalitiesExample?: boolean;
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 }) => {
   return `<!-- Chat widget sample HTML -->
 <!-- Downloaded from https://nlxai.github.io/chat-sdk -->
@@ -68,6 +72,8 @@ export const setupSnippet = ({
   </head>
   <body>
     ${umdScriptTags.chatWidget}${
+      // initial eslint integration
+      // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
       customModalitiesExample
         ? `
     <script defer src="https://cdnjs.cloudflare.com/ajax/libs/htm/3.1.1/htm.js" integrity="sha512-RilD4H0wcNNxG2GvB+L1LRXCntT0zgRvRLnmGu+e9wWaLKGkPifz3Ozb6+WPsyEkTBLw6zWCwwEjs9JLL1KIHg==" crossorigin="anonymous" referrerpolicy="no-referrer"></script>`
@@ -75,6 +81,8 @@ export const setupSnippet = ({
     }
     <script>
       window.addEventListener("DOMContentLoaded", () => {${
+        // initial eslint integration
+        // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
         customModalitiesExample
           ? `
 
@@ -101,14 +109,22 @@ export const setupSnippet = ({
       }
         const widget = nlxai.chatWidget.create({
           config: {
-            botUrl: "${config.botUrl || "REPLACE_WITH_BOT_URL"}",
+            botUrl: "${
+              // initial eslint integration
+              // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
+              config.botUrl || "REPLACE_WITH_BOT_URL"
+            }",
             headers: {
               "nlx-api-key": "${
+                // initial eslint integration
+                // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
                 config.headers?.["nlx-api-key"] || "REPLACE_WITH_API_KEY"
               }"
             },
             languageCode: "${config.languageCode}"
           },${
+            // initial eslint integration
+            // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
             customModalitiesExample
               ? `
           // Include custom embeddable component under the 'customModalities' field
@@ -154,6 +170,8 @@ storeIn: "localStorage",
                   : ""
           }
           ${
+            // initial eslint integration
+            // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
             theme
               ? `theme: ${indentBy(
                   "          ",
@@ -592,6 +610,8 @@ export const voiceCompassSnippet = ({
 }: {
   config?: Partial<MMConfig>;
   environment?: Environment;
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 }) => {
   const conversationId = (() => {
     if (config !== undefined) {
@@ -625,31 +645,53 @@ export const voiceCompassSnippet = ({
     environment === Environment.Html ? "nlxai." : ""
   }voiceCompass.create({
   // hard-coded params
-  apiKey: "${config?.apiKey || "REPLACE_WITH_API_KEY"}",
-  workspaceId: "${config?.workspaceId || "REPLACE_WITH_WORKSPACE_ID"}",
-  journeyId: "${config?.journeyId || "REPLACE_WITH_JOURNEY_ID"}",
+  apiKey: "${
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
+    config?.apiKey || "REPLACE_WITH_API_KEY"
+  }",
+  workspaceId: "${
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
+    config?.workspaceId || "REPLACE_WITH_WORKSPACE_ID"
+  }",
+  journeyId: "${
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
+    config?.journeyId || "REPLACE_WITH_JOURNEY_ID"
+  }",
   // dynamic params
   conversationId: ${conversationId},
   languageCode: ${languageCode},
 });
 
-client.sendStep("${config?.testStepId || "REPLACE_WITH_STEP_ID"}");`;
+client.sendStep("${
+    // initial eslint integration
+    // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions, @typescript-eslint/prefer-nullish-coalescing
+    config?.testStepId || "REPLACE_WITH_STEP_ID"
+  }");`;
 };
 
 type ScriptTagsType = Record<keyof typeof umdScriptSrc, string>;
-export const umdScriptTags = Object.keys(umdScriptSrc).reduce<ScriptTagsType>(
+export const umdScriptTags: ScriptTagsType = (
+  Object.keys(umdScriptSrc) as Array<keyof typeof umdScriptSrc>
+).reduce<ScriptTagsType>(
   (acc, key) => ({
     ...acc,
     [key]: `<script defer src="${
       umdScriptSrc[key as keyof typeof umdScriptSrc]
     }"></script>`,
   }),
+
+  // eslint-disable-next-line @typescript-eslint/prefer-reduce-type-parameter, @typescript-eslint/consistent-type-assertions
   {} as ScriptTagsType,
 );
 
 export const voiceCompassSetupSnippet = (cfg: {
   config?: Partial<MMConfig>;
   environment?: Environment;
+  // initial eslint integration
+  // eslint-disable-next-line @typescript-eslint/explicit-function-return-type
 }) => {
   if (cfg.environment === Environment.Html) {
     return `${umdScriptTags.voiceCompass}
diff --git a/packages/website/tsconfig.json b/packages/website/tsconfig.json
index dd94b1c2..3d3f19e1 100644
--- a/packages/website/tsconfig.json
+++ b/packages/website/tsconfig.json
@@ -3,7 +3,7 @@
     "strict": true,
     "outDir": "./lib",
     "module": "es2020",
-    "moduleResolution": "node",
+    "moduleResolution": "bundler",
     "target": "es2020",
     "skipLibCheck": true,
     "declaration": true,