docs: everything else

Author: iainmcampbell

docs/ExtensionPoints/ReadMe.md

@@ -0,0 +1,3 @@
+# Extensions Master List
+
+- [SubscriptionManagementExtension](./SubscriptionManagementExtension.md)

docs/ExtensionPoints/SubscriptionManagementExtension.md

@@ -0,0 +1,36 @@
+# Subscription Management Extension
+
+This extension renders in the Product Details and Product Variants Page and is housed inside a Modal container.
+
+## Allowed components
+
+- [Badge](../Components/Badge.md)
+- [Banner](../Components/Banner.md)
+- [Button](../Components/Button.md)
+- [Checkbox](../Components/Checkbox.md)
+- [Clickable](../Components/Clickable.md)
+- [Icon](../Components/Icon.md)
+- [Link](../Components/Link.md)
+- [Radio](../Components/Radio.md)
+- [ResourceItem](../Components/ResourceItem.md)
+- [ResourceList](../Components/ResourceList.md)
+- [Select](../Components/Select.md)
+- [Spinner](../Components/Spinner.md)
+- [Stack](../Components/Stack.md)
+- [StackItem](../Components/StackItem.md)
+- [Text](../Components/Text.md)
+- [TextField](../Components/TextField.md)
+- [Thumbnail](../Components/Thumbnail.md)
+
+## Available utilities/input
+
+- [Modal Actions](../Utilities/ModalActions.md)
+- [Layout](../Utilities/Layout.md)
+- [Locale](../Utilities/Locale.md)
+- [Product Data](../Utilities/ProductData.md)
+- [Session Token](../Utilities/SessionToken.md)
+- [Toast](../Utilities/Toast.md)
+
+## Product Data
+
+TODO - Product data structure goes here

docs/ExternalAPI/ReadMe.md

@@ -0,0 +1,8 @@
+## Hitting an external API
+
+A subset of fetch is made available in the extension’s context.
+You can use this to make API calls to your app’s backend service.
+
+You can acquire a [session token](../Utilities/SessionToken.md) to authenticate the API call with your app’s backend service.
+
+Currently, calls to Shopify APIs must be made by your app’s backend service.

docs/ReadMe.md

@@ -0,0 +1,75 @@
+# Client Side Documentation
+
+## Contents
+
+- [Extension Points](./ExtensionPoints/README.md)
+- [Components](./Components/README.md)
+- [Utilities](./Utilities/README.md)
+- [Calling external APIs](./ExternalApi/README.md)
+
+## Getting Started
+
+### 1. Install the Shopify CLI
+
+Follow the instructions to install the app Shopify CLI (extensions fork [here](https://github.com/Shopify/shopify-app-cli-extensions))
+
+### 2. Create an extension
+
+Run `shopify create extension` to get started.
+This command will clone an extension template, which contains a basic extension.
+
+### 3. Run the local server
+
+Run `shopify serve` and start coding! All the code you will write for your extension should be within the `src` folder using the index entry point generated. This ensures that the CLI will know what to bundle when pushing your extension to shopify.
+
+## Render API
+
+The `render` method provided by Argo lets you tell Shopify what you want to render and where you want to render it.
+It’s similar to `ReactDOM.render`, but works with vanilla JavaScript:
+
+```js
+render(ExtensionPoint, renderCallback);
+```
+
+#### Arguments
+
+- `ExtensionPoint`: Where in the Shopify Admin the extension should render. Import this enum from Argo.
+- `renderCallback`: A method that returns Argo components to be rendered.
+
+#### Vanilla Example
+
+```js
+import {ExtensionPoint, render, Text} from '@shopify/argo-admin';
+
+render(ExtensionPoint.MyExtension, (root) => {
+  const text = root.createComponent(TextField, {
+    style: 'strong',
+    alignment: 'center'
+  });
+
+  text.appendChild('This is the best extension.');
+  root.appendChild(text);
+
+  root.mount();
+});
+```
+
+#### React Example
+
+```js
+import {ExtensionPoint, render, Text} from '@shopify/argo-admin';
+
+function App() {
+  return (
+    <Text
+      style="strong"
+      alignment="center"
+    >
+      This is the best extension.
+    </Text>
+  )
+}
+
+render(ExtensionPoint.MyExtension, () => <App />);
+```
+