diff --git a/packages/techdocs-common/src/stages/publish/awsS3.test.ts b/packages/techdocs-common/src/stages/publish/awsS3.test.ts
new file mode 100644
index 0000000000..08189a52dc
--- /dev/null
+++ b/packages/techdocs-common/src/stages/publish/awsS3.test.ts
@@ -0,0 +1,117 @@
+/*
+ * Copyright 2020 Spotify AB
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import mockFs from 'mock-fs';
+import * as winston from 'winston';
+import { ConfigReader } from '@backstage/config';
+import { AwsS3Publish } from './awsS3';
+import { PublisherBase } from './types';
+
+const createMockEntity = (annotations = {}) => {
+  return {
+    apiVersion: 'version',
+    kind: 'TestKind',
+    metadata: {
+      name: 'test-component-name',
+      annotations: {
+        ...annotations,
+      },
+    },
+  };
+};
+
+const logger = winston.createLogger();
+jest.spyOn(logger, 'info').mockReturnValue(logger);
+
+let publisher: PublisherBase;
+
+beforeEach(() => {
+  const mockConfig = new ConfigReader({
+    techdocs: {
+      requestUrl: 'http://localhost:7000',
+      publisher: {
+        type: 'awsS3',
+        awsS3: {
+          credentials: '{}',
+          bucketName: 'bucketName',
+        },
+      },
+    },
+  });
+
+  publisher = AwsS3Publish.fromConfig(mockConfig, logger);
+});
+
+describe('AwsS3Publish', () => {
+  it('should publish a directory', async () => {
+    mockFs({
+      '/path/to/generatedDirectory': {
+        'index.html': '',
+        '404.html': '',
+        assets: {
+          'main.css': '',
+        },
+      },
+    });
+
+    const entity = createMockEntity();
+    expect(
+      await publisher.publish({
+        entity,
+        directory: '/path/to/generatedDirectory',
+      }),
+    ).toBeUndefined();
+    mockFs.restore();
+  });
+
+  it('should return true if docs has been generated', async () => {
+    const entityMock = {
+      apiVersion: 'apiVersion',
+      kind: 'kind',
+      metadata: {
+        namespace: '/namespace',
+        name: 'name',
+      },
+    };
+    const entityRootDir = `${entityMock.metadata.namespace}/${entityMock.kind}/${entityMock.metadata.name}`;
+    mockFs({
+      [entityRootDir]: {
+        'index.html': 'file-content',
+      },
+    });
+
+    expect(await publisher.hasDocsBeenGenerated(entityMock)).toBe(true);
+    mockFs.restore();
+  });
+
+  it('should return tech docs metadata', async () => {
+    const entityNameMock = {
+      name: 'name',
+      namespace: '/namespace',
+      kind: 'kind',
+    };
+    const entityRootDir = `${entityNameMock.namespace}/${entityNameMock.kind}/${entityNameMock.name}`;
+    mockFs({
+      [entityRootDir]: {
+        'techdocs_metadata.json': 'file-content'
+      }
+    });
+
+    expect(
+      await publisher.fetchTechDocsMetadata(entityNameMock),
+    ).toBe('file-content');
+    mockFs.restore();
+  });
+});