├── .editorconfig
├── .env.example
├── .eslintrc.js
├── .gcloudignore
├── .gitattributes
├── .github
└── workflows
│ ├── codeql.yml
│ └── copy-to-public.yml
├── .gitignore
├── LICENSE.txt
├── README.md
├── app.yaml
├── cloudbuild.yaml
├── docs
├── creating-custom-content-cards.md
└── index.md
├── package-lock.json
├── package.json
├── public
├── favicon.ico
├── index.html
├── logo192.png
├── logo512.png
├── manifest.json
└── robots.txt
└── src
├── Router.js
├── components
├── CameraPreview.js
├── Captions.js
├── ContentCardDisplay.js
├── ContentCardSwitch.js
├── ContentCards
│ ├── Image.js
│ ├── ImageCarousel.js
│ ├── Link.js
│ ├── Markdown.js
│ ├── Options.js
│ ├── Transcript.js
│ └── Video.js
├── Controls.js
├── FeedbackModal.js
├── Header.js
├── PersonaVideo.js
├── STTFeedback.js
└── TextInput.js
├── config.js
├── eula.js
├── globalStyle.js
├── img
├── camera-video-fill.svg
├── mic-fill.svg
├── mic.svg
├── placeholder-headshot.png
└── sm-logo-retina.webp
├── index.js
├── proxyVideo.js
├── reportWebVitals.js
├── routes
├── ContentCardTest.js
├── DPChat.js
├── Feedback.js
├── FeedbackRoute.js
├── Landing.js
└── Loading.js
├── setupTests.js
├── store
├── index.js
└── sm
│ ├── index.js
│ └── meatball.js
└── utils
├── Modal.js
├── breakpoints.js
├── camera.js
└── roundObject.js
/.editorconfig:
--------------------------------------------------------------------------------
1 | # EditorConfig is awesome: https://EditorConfig.org
2 |
3 | # top-most EditorConfig file
4 | root = true
5 |
6 | [*]
7 | indent_style = space
8 | indent_size = 2
9 | end_of_line = lf
10 | charset = utf-8
11 | trim_trailing_whitespace = true
12 | insert_final_newline = true
--------------------------------------------------------------------------------
/.env.example:
--------------------------------------------------------------------------------
1 | # there are more configuration values in /src/config.js such as colors and background
2 |
3 | # env vars that are passed in to the react app need to be prefixed with REACT_APP_
4 |
5 | # this usually doesn't need to be changed for standard projects
6 | REACT_APP_SESSION_SERVER="dh.soulmachines.cloud"
7 | # API key can be configured in DDNA prefs, good for basic auth when using a supported NLP
8 | REACT_APP_API_KEY=""
9 | # endpoint to token server corresponding to project's persona
10 | # token server auth is used when an orchestration server is being used to handle NLP
11 | REACT_APP_TOKEN_URL=https://example.com/auth/authorize
12 |
13 | # you can either use an API key or a token server to connect to your persona.
14 | # 0: API key
15 | # 1: token server
16 | REACT_APP_PERSONA_AUTH_MODE=0
17 | # enable if using an orchestration server (usually for non-native NLP or custom backend logic)
18 | REACT_APP_ORCHESTRATION_MODE=false
19 |
20 | # local development server will serve app from this port
21 | PORT=3000
22 |
23 | # uncomment if using Google Analytics
24 | # REACT_APP_GA_TRACKING_ID=G-XXXXXXXXXXX
25 |
26 | # without this flag, any eslint errors will prevent the app from building
27 | ESLINT_NO_DEV_ERRORS=true
28 | # suppress source map errors present when using react-scripts@5.0.1
29 | GENERATE_SOURCEMAP=false
30 |
--------------------------------------------------------------------------------
/.eslintrc.js:
--------------------------------------------------------------------------------
1 | module.exports = {
2 | env: {
3 | browser: true,
4 | es2021: true,
5 | },
6 | extends: [
7 | 'plugin:react/recommended',
8 | 'airbnb',
9 | ],
10 | parser: '@typescript-eslint/parser',
11 | parserOptions: {
12 | ecmaFeatures: {
13 | jsx: true,
14 | },
15 | ecmaVersion: 12,
16 | sourceType: 'module',
17 | },
18 | plugins: [
19 | 'react',
20 | '@typescript-eslint',
21 | ],
22 | rules: {
23 | 'react/jsx-filename-extension': 0,
24 | 'no-console': 0,
25 | 'default-param-last': 0,
26 | 'linebreak-style': ['error', process.platform === 'win32' ? 'windows' : 'unix'],
27 | },
28 | };
29 |
--------------------------------------------------------------------------------
/.gcloudignore:
--------------------------------------------------------------------------------
1 | # This file specifies files that are *not* uploaded to Google Cloud Platform
2 | # using gcloud. It follows the same syntax as .gitignore, with the addition of
3 | # "#!include" directives (which insert the entries of the given .gitignore-style
4 | # file at that point).
5 | #
6 | # For more information, run:
7 | # $ gcloud topic gcloudignore
8 | #
9 | .gcloudignore
10 | # If you would like to upload your .git directory, .gitignore file or files
11 | # from your .gitignore file, remove the corresponding line
12 | # below:
13 | .git
14 | .gitignore
15 |
16 | # Node.js dependencies:
17 | node_modules/
--------------------------------------------------------------------------------
/.gitattributes:
--------------------------------------------------------------------------------
1 | # Auto detect text files and perform EOL normalization
2 | * text=auto
3 |
--------------------------------------------------------------------------------
/.github/workflows/codeql.yml:
--------------------------------------------------------------------------------
1 | # For most projects, this workflow file will not need changing; you simply need
2 | # to commit it to your repository.
3 | #
4 | # You may wish to alter this file to override the set of languages analyzed,
5 | # or to provide custom queries or build logic.
6 | #
7 | # ******** NOTE ********
8 | # We have attempted to detect the languages in your repository. Please check
9 | # the `language` matrix defined below to confirm you have the correct set of
10 | # supported CodeQL languages.
11 | #
12 | name: "CodeQL"
13 |
14 | on:
15 | push:
16 | branches: [ "main" ]
17 | pull_request:
18 | # The branches below must be a subset of the branches above
19 | branches: [ "main" ]
20 | schedule:
21 | - cron: '21 6 * * 2'
22 |
23 | jobs:
24 | analyze:
25 | name: Analyze
26 | runs-on: ubuntu-latest
27 | permissions:
28 | actions: read
29 | contents: read
30 | security-events: write
31 |
32 | strategy:
33 | fail-fast: false
34 | matrix:
35 | language: [ 'javascript' ]
36 | # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python', 'ruby' ]
37 | # Learn more about CodeQL language support at https://aka.ms/codeql-docs/language-support
38 |
39 | steps:
40 | - name: Checkout repository
41 | uses: actions/checkout@v3
42 |
43 | # Initializes the CodeQL tools for scanning.
44 | - name: Initialize CodeQL
45 | uses: github/codeql-action/init@v2
46 | with:
47 | languages: ${{ matrix.language }}
48 | queries: security-and-quality
49 | # If you wish to specify custom queries, you can do so here or in a config file.
50 | # By default, queries listed here will override any specified in a config file.
51 | # Prefix the list here with "+" to use these queries and those in the config file.
52 |
53 | # Details on CodeQL's query packs refer to : https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs
54 | # queries: security-extended,security-and-quality
55 |
56 |
57 | # Autobuild attempts to build any compiled languages (C/C++, C#, or Java).
58 | # If this step fails, then you should remove it and run the build manually (see below)
59 | - name: Autobuild
60 | uses: github/codeql-action/autobuild@v2
61 |
62 | # ℹ️ Command-line programs to run using the OS shell.
63 | # 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun
64 |
65 | # If the Autobuild fails above, remove it and uncomment the following three lines.
66 | # modify them (or add more) to build your code if your project, please refer to the EXAMPLE below for guidance.
67 |
68 | # - run: |
69 | # echo "Run, Build Application using script"
70 | # ./location_of_script_within_repo/buildscript.sh
71 |
72 | - name: Perform CodeQL Analysis
73 | uses: github/codeql-action/analyze@v2
74 |
--------------------------------------------------------------------------------
/.github/workflows/copy-to-public.yml:
--------------------------------------------------------------------------------
1 | name: "copy to react-reference-ui-public"
2 |
3 | on:
4 | push:
5 | branches: ['main']
6 |
7 | jobs:
8 | copy-to-branches:
9 | runs-on: ubuntu-latest
10 | steps:
11 | - uses: actions/checkout@v2
12 | - name: Pushes to another repository
13 | uses: cpina/github-action-push-to-another-repository@main
14 | env:
15 | SSH_DEPLOY_KEY: ${{ secrets.SSH_PRIVATE_KEY }}
16 | with:
17 | source-directory: '.'
18 | destination-github-username: 'soulmachines'
19 | destination-repository-name: 'react-reference-ui-public'
20 | user-email: jade.fung@soulmachines.com
21 | target-branch: main
22 |
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 |
2 | # Created by https://www.toptal.com/developers/gitignore/api/node,macos,vim
3 | # Edit at https://www.toptal.com/developers/gitignore?templates=node,macos,vim
4 |
5 | ### macOS ###
6 | # General
7 | .DS_Store
8 | .AppleDouble
9 | .LSOverride
10 |
11 | # Icon must end with two \r
12 | Icon
13 |
14 |
15 | # Thumbnails
16 | ._*
17 |
18 | # Files that might appear in the root of a volume
19 | .DocumentRevisions-V100
20 | .fseventsd
21 | .Spotlight-V100
22 | .TemporaryItems
23 | .Trashes
24 | .VolumeIcon.icns
25 | .com.apple.timemachine.donotpresent
26 |
27 | # Directories potentially created on remote AFP share
28 | .AppleDB
29 | .AppleDesktop
30 | Network Trash Folder
31 | Temporary Items
32 | .apdisk
33 |
34 | ### Node ###
35 | # Logs
36 | logs
37 | *.log
38 | npm-debug.log*
39 | yarn-debug.log*
40 | yarn-error.log*
41 | lerna-debug.log*
42 |
43 | # Diagnostic reports (https://nodejs.org/api/report.html)
44 | report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
45 |
46 | # Runtime data
47 | pids
48 | *.pid
49 | *.seed
50 | *.pid.lock
51 |
52 | # Directory for instrumented libs generated by jscoverage/JSCover
53 | lib-cov
54 |
55 | # Coverage directory used by tools like istanbul
56 | coverage
57 | *.lcov
58 |
59 | # nyc test coverage
60 | .nyc_output
61 |
62 | # Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
63 | .grunt
64 |
65 | # Bower dependency directory (https://bower.io/)
66 | bower_components
67 |
68 | # node-waf configuration
69 | .lock-wscript
70 |
71 | # Compiled binary addons (https://nodejs.org/api/addons.html)
72 | build/Release
73 |
74 | # Dependency directories
75 | node_modules/
76 | jspm_packages/
77 |
78 | # TypeScript v1 declaration files
79 | typings/
80 |
81 | # TypeScript cache
82 | *.tsbuildinfo
83 |
84 | # Optional npm cache directory
85 | .npm
86 |
87 | # Optional eslint cache
88 | .eslintcache
89 |
90 | # Optional stylelint cache
91 | .stylelintcache
92 |
93 | # Microbundle cache
94 | .rpt2_cache/
95 | .rts2_cache_cjs/
96 | .rts2_cache_es/
97 | .rts2_cache_umd/
98 |
99 | # Optional REPL history
100 | .node_repl_history
101 |
102 | # Output of 'npm pack'
103 | *.tgz
104 |
105 | # Yarn Integrity file
106 | .yarn-integrity
107 |
108 | # dotenv environment variables file
109 | .env
110 | .env.test
111 | .env*.local
112 |
113 | # parcel-bundler cache (https://parceljs.org/)
114 | .cache
115 | .parcel-cache
116 |
117 | # Next.js build output
118 | .next
119 |
120 | # Nuxt.js build / generate output
121 | .nuxt
122 | dist
123 |
124 | # Storybook build outputs
125 | .out
126 | .storybook-out
127 | storybook-static
128 |
129 | # rollup.js default build output
130 | dist/
131 |
132 | # Gatsby files
133 | .cache/
134 | # Comment in the public line in if your project uses Gatsby and not Next.js
135 | # https://nextjs.org/blog/next-9-1#public-directory-support
136 | # public
137 |
138 | # vuepress build output
139 | .vuepress/dist
140 |
141 | # Serverless directories
142 | .serverless/
143 |
144 | # FuseBox cache
145 | .fusebox/
146 |
147 | # DynamoDB Local files
148 | .dynamodb/
149 |
150 | # TernJS port file
151 | .tern-port
152 |
153 | # Stores VSCode versions used for testing VSCode extensions
154 | .vscode-test
155 |
156 | # Temporary folders
157 | tmp/
158 | temp/
159 |
160 | ### Vim ###
161 | # Swap
162 | [._]*.s[a-v][a-z]
163 | !*.svg # comment out if you don't need vector files
164 | [._]*.sw[a-p]
165 | [._]s[a-rt-v][a-z]
166 | [._]ss[a-gi-z]
167 | [._]sw[a-p]
168 |
169 | # Session
170 | Session.vim
171 | Sessionx.vim
172 |
173 | # Temporary
174 | .netrwhist
175 | *~
176 | # Auto-generated tag files
177 | tags
178 | # Persistent undo
179 | [._]*.un~
180 |
181 | # End of https://www.toptal.com/developers/gitignore/api/node,macos,vim
182 |
183 | ### vscode ###
184 | .vscode
185 | .vscode/*
186 | !.vscode/settings.json
187 | !.vscode/tasks.json
188 | !.vscode/launch.json
189 | !.vscode/extensions.json
190 | *.code-workspace
191 |
192 | # End of https://www.toptal.com/developers/gitignore/api/vscode
193 | build
194 | sm-embed.css
195 | sm-embed.js
196 |
197 | .secrets
198 |
--------------------------------------------------------------------------------
/LICENSE.txt:
--------------------------------------------------------------------------------
1 | Apache License
2 | Version 2.0, January 2004
3 | http://www.apache.org/licenses/
4 |
5 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6 |
7 | 1. Definitions.
8 |
9 | "License" shall mean the terms and conditions for use, reproduction,
10 | and distribution as defined by Sections 1 through 9 of this document.
11 |
12 | "Licensor" shall mean the copyright owner or entity authorized by
13 | the copyright owner that is granting the License.
14 |
15 | "Legal Entity" shall mean the union of the acting entity and all
16 | other entities that control, are controlled by, or are under common
17 | control with that entity. For the purposes of this definition,
18 | "control" means (i) the power, direct or indirect, to cause the
19 | direction or management of such entity, whether by contract or
20 | otherwise, or (ii) ownership of fifty percent (50%) or more of the
21 | outstanding shares, or (iii) beneficial ownership of such entity.
22 |
23 | "You" (or "Your") shall mean an individual or Legal Entity
24 | exercising permissions granted by this License.
25 |
26 | "Source" form shall mean the preferred form for making modifications,
27 | including but not limited to software source code, documentation
28 | source, and configuration files.
29 |
30 | "Object" form shall mean any form resulting from mechanical
31 | transformation or translation of a Source form, including but
32 | not limited to compiled object code, generated documentation,
33 | and conversions to other media types.
34 |
35 | "Work" shall mean the work of authorship, whether in Source or
36 | Object form, made available under the License, as indicated by a
37 | copyright notice that is included in or attached to the work
38 | (an example is provided in the Appendix below).
39 |
40 | "Derivative Works" shall mean any work, whether in Source or Object
41 | form, that is based on (or derived from) the Work and for which the
42 | editorial revisions, annotations, elaborations, or other modifications
43 | represent, as a whole, an original work of authorship. For the purposes
44 | of this License, Derivative Works shall not include works that remain
45 | separable from, or merely link (or bind by name) to the interfaces of,
46 | the Work and Derivative Works thereof.
47 |
48 | "Contribution" shall mean any work of authorship, including
49 | the original version of the Work and any modifications or additions
50 | to that Work or Derivative Works thereof, that is intentionally
51 | submitted to Licensor for inclusion in the Work by the copyright owner
52 | or by an individual or Legal Entity authorized to submit on behalf of
53 | the copyright owner. For the purposes of this definition, "submitted"
54 | means any form of electronic, verbal, or written communication sent
55 | to the Licensor or its representatives, including but not limited to
56 | communication on electronic mailing lists, source code control systems,
57 | and issue tracking systems that are managed by, or on behalf of, the
58 | Licensor for the purpose of discussing and improving the Work, but
59 | excluding communication that is conspicuously marked or otherwise
60 | designated in writing by the copyright owner as "Not a Contribution."
61 |
62 | "Contributor" shall mean Licensor and any individual or Legal Entity
63 | on behalf of whom a Contribution has been received by Licensor and
64 | subsequently incorporated within the Work.
65 |
66 | 2. Grant of Copyright License. Subject to the terms and conditions of
67 | this License, each Contributor hereby grants to You a perpetual,
68 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable
69 | copyright license to reproduce, prepare Derivative Works of,
70 | publicly display, publicly perform, sublicense, and distribute the
71 | Work and such Derivative Works in Source or Object form.
72 |
73 | 3. Grant of Patent License. Subject to the terms and conditions of
74 | this License, each Contributor hereby grants to You a perpetual,
75 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable
76 | (except as stated in this section) patent license to make, have made,
77 | use, offer to sell, sell, import, and otherwise transfer the Work,
78 | where such license applies only to those patent claims licensable
79 | by such Contributor that are necessarily infringed by their
80 | Contribution(s) alone or by combination of their Contribution(s)
81 | with the Work to which such Contribution(s) was submitted. If You
82 | institute patent litigation against any entity (including a
83 | cross-claim or counterclaim in a lawsuit) alleging that the Work
84 | or a Contribution incorporated within the Work constitutes direct
85 | or contributory patent infringement, then any patent licenses
86 | granted to You under this License for that Work shall terminate
87 | as of the date such litigation is filed.
88 |
89 | 4. Redistribution. You may reproduce and distribute copies of the
90 | Work or Derivative Works thereof in any medium, with or without
91 | modifications, and in Source or Object form, provided that You
92 | meet the following conditions:
93 |
94 | (a) You must give any other recipients of the Work or
95 | Derivative Works a copy of this License; and
96 |
97 | (b) You must cause any modified files to carry prominent notices
98 | stating that You changed the files; and
99 |
100 | (c) You must retain, in the Source form of any Derivative Works
101 | that You distribute, all copyright, patent, trademark, and
102 | attribution notices from the Source form of the Work,
103 | excluding those notices that do not pertain to any part of
104 | the Derivative Works; and
105 |
106 | (d) If the Work includes a "NOTICE" text file as part of its
107 | distribution, then any Derivative Works that You distribute must
108 | include a readable copy of the attribution notices contained
109 | within such NOTICE file, excluding those notices that do not
110 | pertain to any part of the Derivative Works, in at least one
111 | of the following places: within a NOTICE text file distributed
112 | as part of the Derivative Works; within the Source form or
113 | documentation, if provided along with the Derivative Works; or,
114 | within a display generated by the Derivative Works, if and
115 | wherever such third-party notices normally appear. The contents
116 | of the NOTICE file are for informational purposes only and
117 | do not modify the License. You may add Your own attribution
118 | notices within Derivative Works that You distribute, alongside
119 | or as an addendum to the NOTICE text from the Work, provided
120 | that such additional attribution notices cannot be construed
121 | as modifying the License.
122 |
123 | You may add Your own copyright statement to Your modifications and
124 | may provide additional or different license terms and conditions
125 | for use, reproduction, or distribution of Your modifications, or
126 | for any such Derivative Works as a whole, provided Your use,
127 | reproduction, and distribution of the Work otherwise complies with
128 | the conditions stated in this License.
129 |
130 | 5. Submission of Contributions. Unless You explicitly state otherwise,
131 | any Contribution intentionally submitted for inclusion in the Work
132 | by You to the Licensor shall be under the terms and conditions of
133 | this License, without any additional terms or conditions.
134 | Notwithstanding the above, nothing herein shall supersede or modify
135 | the terms of any separate license agreement you may have executed
136 | with Licensor regarding such Contributions.
137 |
138 | 6. Trademarks. This License does not grant permission to use the trade
139 | names, trademarks, service marks, or product names of the Licensor,
140 | except as required for reasonable and customary use in describing the
141 | origin of the Work and reproducing the content of the NOTICE file.
142 |
143 | 7. Disclaimer of Warranty. Unless required by applicable law or
144 | agreed to in writing, Licensor provides the Work (and each
145 | Contributor provides its Contributions) on an "AS IS" BASIS,
146 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147 | implied, including, without limitation, any warranties or conditions
148 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149 | PARTICULAR PURPOSE. You are solely responsible for determining the
150 | appropriateness of using or redistributing the Work and assume any
151 | risks associated with Your exercise of permissions under this License.
152 |
153 | 8. Limitation of Liability. In no event and under no legal theory,
154 | whether in tort (including negligence), contract, or otherwise,
155 | unless required by applicable law (such as deliberate and grossly
156 | negligent acts) or agreed to in writing, shall any Contributor be
157 | liable to You for damages, including any direct, indirect, special,
158 | incidental, or consequential damages of any character arising as a
159 | result of this License or out of the use or inability to use the
160 | Work (including but not limited to damages for loss of goodwill,
161 | work stoppage, computer failure or malfunction, or any and all
162 | other commercial damages or losses), even if such Contributor
163 | has been advised of the possibility of such damages.
164 |
165 | 9. Accepting Warranty or Additional Liability. While redistributing
166 | the Work or Derivative Works thereof, You may choose to offer,
167 | and charge a fee for, acceptance of support, warranty, indemnity,
168 | or other liability obligations and/or rights consistent with this
169 | License. However, in accepting such obligations, You may act only
170 | on Your own behalf and on Your sole responsibility, not on behalf
171 | of any other Contributor, and only if You agree to indemnify,
172 | defend, and hold each Contributor harmless for any liability
173 | incurred by, or claims asserted against, such Contributor by reason
174 | of your accepting any such warranty or additional liability.
175 |
176 | END OF TERMS AND CONDITIONS
177 |
178 | APPENDIX: How to apply the Apache License to your work.
179 |
180 | To apply the Apache License to your work, attach the following
181 | boilerplate notice, with the fields enclosed by brackets "[]"
182 | replaced with your own identifying information. (Don't include
183 | the brackets!) The text should be enclosed in the appropriate
184 | comment syntax for the file format. We also recommend that a
185 | file or class name and description of purpose be included on the
186 | same "printed page" as the copyright notice for easier
187 | identification within third-party archives.
188 |
189 | Copyright [yyyy] [name of copyright owner]
190 |
191 | Licensed under the Apache License, Version 2.0 (the "License");
192 | you may not use this file except in compliance with the License.
193 | You may obtain a copy of the License at
194 |
195 | http://www.apache.org/licenses/LICENSE-2.0
196 |
197 | Unless required by applicable law or agreed to in writing, software
198 | distributed under the License is distributed on an "AS IS" BASIS,
199 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200 | See the License for the specific language governing permissions and
201 | limitations under the License.
202 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # Soul Machines React Reference UI
2 |
3 | This template succeeds the previous [react-template](https://github.com/soulmachines/react-template). This is re-write is based on [create-react-app](https://github.com/facebook/create-react-app) and is designed mainly to provide a simple and familiar developer experience.
4 |
5 | This template contains functional examples of how the user flow and interaction with the Digital Person should work, and likley require styling chanages to suit branding requirements.
6 |
7 | ## Setup
8 |
9 | In order to run this application, you'll either need an API key or a token server. Most projects will use an API key--token servers are only necessary when interfacing with a non-native NLP through a orchestration server.
10 |
11 | ### Copy `.env.example` contents into `.env`
12 | Create an empty text file called `.env` and copy the contents of `.env.example` into it. These environment variables are required for the UI to run.
13 |
14 | If using an API key, set `REACT_APP_PERSONA_AUTH_MODE` to `0` and populate `REACT_APP_API_KEY` with your key.
15 |
16 | If using an orchestration server, set `REACT_APP_PERSONA_AUTH_MODE` to `1` and populate `REACT_APP_TOKEN_URL` with your token server endpoint and set `REACT_APP_TOKEN_URL` to `true`.
17 |
18 | ### `npm install`
19 | Run to install the project's dependencies.
20 |
21 | ### `npm start`
22 | Starts the development server. Open [http://localhost:3000](http://localhost:3000) to view it in the browser. The page will automatically reload when you make changes.
23 |
24 | ### `npm run build`
25 | Builds the app for production to the `build` folder. The files will be bundled and minified for production.
26 |
27 | ## License
28 |
29 | Soul Machines React Reference UI is available under the Apache License, Version 2.0. See the [LICENSE.txt](./LICENSE.txt) file for more info.
30 |
31 | ## Linting & Code Style
32 |
33 | This project strictly follows [AirBnB's JavaScript style guide](https://github.com/airbnb/javascript). We recommend you install [ESLint](https://eslint.org/) in your editor and adhere to its recommendations.
34 |
35 | We have also provided an `.editorconfig` file that you can use in your editor to match the indentation, whitespace, and other styling rules we used in creating this template.
36 |
37 | ## Support
38 | Our team would love to hear from you. For any additional support, feedback, bugs, feature requests, please [submit a ticket](https://support.soulmachines.com) or reach out to us at [support@soulmachines.com](support@soulmachines.com).
39 |
--------------------------------------------------------------------------------
/app.yaml:
--------------------------------------------------------------------------------
1 | # [START appengine_websockets_yaml]
2 | runtime: nodejs16
3 | service: default
4 |
5 | # Use only a single instance, so that this local-memory-only chat app will work
6 | # consistently with multiple users. To work across multiple instances, an
7 | # extra-instance messaging system or data store would be needed.
8 | manual_scaling:
9 | instances: 1
10 |
11 | handlers:
12 | - url: /static
13 | static_dir: build/static
14 |
15 | - url: /(.*\.(json|ico|js))$
16 | static_files: build/\1
17 | upload: build/.*\.(json|ico|js)$
18 |
19 | - url: .*
20 | static_files: build/index.html
21 | upload: build/index.html
22 |
--------------------------------------------------------------------------------
/cloudbuild.yaml:
--------------------------------------------------------------------------------
1 | steps:
2 | - name: node:14
3 | entrypoint: npm
4 | args: ['install', 'typescript']
5 | - name: node:14
6 | entrypoint: npm
7 | args: ['install']
8 | # run webpack prod script to create static files
9 | - name: node:14
10 | entrypoint: npm
11 | args: ['run','build']
12 | env:
13 | - 'REACT_APP_API_KEY=${_API_KEY}'
14 | - 'REACT_APP_GA_TRACKING_ID=G-G5GWJ2XYRS'
15 | - 'DISABLE_ESLINT_PLUGIN=true'
16 | - 'REACT_APP_SESSION_SERVER=${_SESSION_SERVER}'
17 | - 'REACT_APP_PERSONA_AUTH_MODE=0'
18 | - 'REACT_APP_ORCHESTRATION_MODE=false'
19 | - 'GENERATE_SOURCEMAP=false'
20 | - name: "gcr.io/cloud-builders/gcloud"
21 | args: ["app", "deploy"]
22 | timeout: "1600s"
23 |
--------------------------------------------------------------------------------
/docs/creating-custom-content-cards.md:
--------------------------------------------------------------------------------
1 | # Creating custom content cards
2 |
3 | Creating a custom content card is relatively simple and involves two main steps: creating your card component in `src/components/ContentCards/` and adding your card to the map in `src/components/ContentCardSwitch.js`.
4 |
5 | ## Creating a new content card component
6 |
7 | Content cards can be as simple or complex as you need.
8 |
9 | ### Predefined arguments
10 |
11 | Content cards are passed an object as the first arguments that contain at least four key-value pairs: `id`, `data`, `triggerRemoval`, and `inTranscript`.
12 |
13 | `id` is the name of the content card payload as defined in the corpus. When you call `@showCards(cardID)` in your dialog, the persona server will pass the value of `cardID` to the UI at the moment the speech marker is called, allowing you to show a content card at just the right time.
14 |
15 | Your conversation engineer should note that content cards name must be prefixed with `public-`, however this will be truncated by the persona server, and the value for `id` will be everything following the prefix.
16 |
17 | The `data` object contains whatever data payload you've defined in your corpus. For example, here's what a potential payload for an `options` content card could look like:
18 | ```json
19 | {
20 | "public-menuoptions": {
21 | "component": "options",
22 | "data": {
23 | "options": [
24 | {
25 | "label": "First Option",
26 | "value": "first-option"
27 | },
28 | {
29 | "label": "Second Option",
30 | "value": "second-option"
31 | }
32 | ]
33 | }
34 | }
35 | }
36 | ```
37 |
38 | `triggerRemoval` is a function that the component can call if you need it to hide itself at an arbitrary time. For example, in the stock video component, the user is expected to click on the component several times, but we only want a click on "I'm done" to hide the card.
39 |
40 | `inTranscript` is a boolean value that indicates whether the content card is being displayed inside of the transcript. The transcript component will show content cards inline with the conversation history. It's important that content cards that take up a large portion of the screen (e.g. the video component) don't disrupt the experience when the transcript is open. In the case of the video component, when on display in the transcript, it renders itself as a small thumbnail that can be clicked on to open the full-screen video experience.
41 |
42 | ### Sending input to the NLP
43 |
44 | Text data can be sent to the NLP by dispatching events to the Redux store, which will interact with `smwebsdk`. `sendTextMessage` or `sendEvent` can be imported and the `connect` method from `react-redux` can be used to dispatch events to Redux. Here is a complete example of a minimal component that sends text and events when a button is pressed:
45 |
46 | ```jsx
47 | import React from 'react';
48 | import { connect } from 'react-redux';
49 | import { sendTextMessage, sendEvent } from '../../store/sm/index';
50 |
51 | const CardThatSendsThings = ({ dispatchText, dispatchEvent, data }) => {
52 | const { textPayload, eventName, eventPayload } = data;
53 | const handleText = () => dispatchText(textPayload);
54 | const handleEvent = () => dispatchEvent({ eventName: eventName, payload: eventPayload });
55 |
56 | return(
57 |
58 | Text:
59 | Event:
60 |
61 | );
62 | }
63 |
64 | const mapDispatchToProps = (dispatch) => ({
65 | dispatchText: (text) => sendTextMessage({ text }),
66 | dispatchEvent: ({ eventName, payload }) => sendEvent({ eventName, payload }),
67 | });
68 |
69 | export default connect(null, mapDispatchToProps)(CardThatSendsThings);
70 | ```
71 |
72 | ## Connecting your component to `ContentCardSwitch`
73 |
74 | The `ContentCardSwitch` component maps the component key of the card payload to the proper React component. To add your component, add a key to the `componentMap` object with an object defining the component handler. `ContentCardSwitch` can also automatically hide a card once it's been clicked on—in this case, we'll set the value of `removeOnClick` to `true`. Using the previous example, we'll render the example card when the `component` key of the content card payload is set to `demoCard`:
75 |
76 | ```jsx
77 | import React from 'react';
78 | import CardThatSendsThings from './ContentCards/CardThatSendsThings';
79 |
80 | const ContentCardSwitch = ({ ... }) => {
81 | const componentMap = {
82 | ...,
83 | demoCard: {
84 | element: CardThatSendsThings,
85 | removeOnClick: true,
86 | },
87 | };
88 | ...
89 | ```
90 |
91 | And to use our card in Dialogflow ES, we could create an utterance: `Here's the demo card we just created! @showCards(firstInstanceOfDemoCard)` and this accompanying payload:
92 |
93 | ```json
94 | {
95 | "soulmachines": {
96 | "public-firstInstanceOfDemoCard": {
97 | "component": "demoCard",
98 | "data": {
99 | "textPayload": "Hello world!",
100 | "eventName": "foo",
101 | "eventPayload": { "foo": "bar" }
102 | }
103 | }
104 | }
105 | }
106 | ```
107 | When defining content card payloads in Dialogflow ES, the data must be a value of the `soulmachines` key.
108 |
109 | At the moment the `@showCards` marker is called, your content card should appear!
--------------------------------------------------------------------------------
/docs/index.md:
--------------------------------------------------------------------------------
1 | This template succeeds the previous [react-template](https://github.com/soulmachines/react-template). This is a complete re-write based off of [create-react-app](https://github.com/facebook/create-react-app) and is designed mainly to provide a simpler and more familiar developer experience.
2 |
3 | This template serves as "opinionated documentation," in that it contains most of the functionality that UI's should have and how to use it. As members of Soul Machines Customer Success engineering, we believe this is a good example of how the user flow and interaction with the Digital Person should work. This template is provided with the expectation that most, if not all, of the styling will be altered.
4 |
5 | ## Setup
6 |
7 | You need a token server to authenticate the UI session with the Soul Machines Persona server. Either Soul Machines will provide an endpoint, or you will have to spin up an instance of [express-token-server](https://github.com/soulmachines/express-token-server) with your credentials from DDNA Studio.
8 |
9 | ### Copy `.env.example` contents into `.env`
10 | Create an empty text file called `.env` and copy the contents of `.env.example` into it. These environment variables are required for the UI to run. Set the value of `REACT_APP_TOKEN_URL` to the endpoint of your token server. Optionally, if you're using an orchestration server, set the value of
11 |
12 | ### `npm install`
13 | Run to install the project's dependencies.
14 |
15 | ### `npm start`
16 | Starts the development server. Open [http://localhost:3000](http://localhost:3000) to view it in the browser. The page will automatically reload when you make changes.
17 |
18 | ### `npm run build`
19 | Builds the app for production to the `build` folder. The files will be bundled and minified for production.
20 |
21 | ## Linting & Code Style
22 |
23 | This project strictly follows [AirBnB's JavaScript style guide](https://github.com/airbnb/javascript). We recommend you install [ESLint](https://eslint.org/) in your editor and adhere to its recommendations.
24 |
25 | We have also provided an `.editorconfig` file that you can use in your editor to match the indentation, whitespace, and other styling rules we used in creating this template.
26 |
27 | ## Docs
28 | - [Creating custom content cards](/creating-custom-content-cards)
--------------------------------------------------------------------------------
/package.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "react-reference-ui",
3 | "version": "1.0.0",
4 | "engines": {
5 | "node": ">=16"
6 | },
7 | "private": true,
8 | "scripts": {
9 | "start": "npm run build && npx serve -s build",
10 | "dev": "react-scripts start",
11 | "build": "react-scripts build",
12 | "test": "react-scripts test",
13 | "eject": "react-scripts eject",
14 | "deploy:gcp": "npm run build && gcloud app deploy --project ui-test-persona-nhyv app.yaml --stop-previous-version --promote --version baseline --quiet"
15 | },
16 | "dependencies": {
17 | "@juggle/resize-observer": "^3.3.1",
18 | "@reduxjs/toolkit": "^1.6.0",
19 | "@soulmachines/smwebsdk": "15.7.0",
20 | "@testing-library/jest-dom": "^5.14.1",
21 | "@testing-library/react": "^11.2.7",
22 | "@testing-library/user-event": "^12.8.3",
23 | "await-to-js": "^3.0.0",
24 | "bootstrap": "5.2.0-beta1",
25 | "color": "^4.2.3",
26 | "dotenv": "^8.2.0",
27 | "framer-motion": "^4.1.17",
28 | "prop-types": "^15.7.2",
29 | "react": "^17.0.2",
30 | "react-bootstrap-icons": "^1.10.2",
31 | "react-dom": "^17.0.2",
32 | "react-ga": "^3.3.1",
33 | "react-ga4": "^1.4.1",
34 | "react-markdown": "^6.0.2",
35 | "react-redux": "^7.2.4",
36 | "react-router-dom": "^5.2.0",
37 | "react-scripts": "5.0.1",
38 | "react-tooltip": "^4.2.21",
39 | "react-youtube": "^7.13.1",
40 | "redux": "^4.1.0",
41 | "redux-thunk": "^2.3.0",
42 | "rehype-sanitize": "^5.0.0",
43 | "remark-gfm": "^2.0.0",
44 | "styled-components": "^5.3.0",
45 | "syllable": "^5.0.0",
46 | "web-vitals": "^1.1.2"
47 | },
48 | "eslintConfig": {
49 | "extends": [
50 | "react-app",
51 | "react-app/jest"
52 | ]
53 | },
54 | "browserslist": {
55 | "production": [
56 | ">0.2%",
57 | "not dead",
58 | "not op_mini all"
59 | ],
60 | "development": [
61 | "last 1 chrome version",
62 | "last 1 firefox version",
63 | "last 1 safari version"
64 | ]
65 | },
66 | "devDependencies": {
67 | "@typescript-eslint/eslint-plugin": "^5.29.0",
68 | "@typescript-eslint/parser": "^5.29.0",
69 | "eslint": "^8.18.0",
70 | "eslint-config-airbnb": "^19.0.4",
71 | "eslint-plugin-import": "^2.26.0",
72 | "eslint-plugin-jsx-a11y": "^6.5.1",
73 | "eslint-plugin-react": "^7.30.0",
74 | "eslint-plugin-react-hooks": "^4.6.0"
75 | }
76 | }
77 |
--------------------------------------------------------------------------------
/public/favicon.ico:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/soulmachines/react-reference-ui-public/352672b9df1c4050c15e2d4de4d52cc36a1cd97d/public/favicon.ico
--------------------------------------------------------------------------------
/public/index.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
12 |
13 |
17 |
18 |
27 | React Reference UI Template
28 |
29 |
30 |
31 |
32 |
42 |
43 |
44 |
45 |
46 |
--------------------------------------------------------------------------------
/public/logo192.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/soulmachines/react-reference-ui-public/352672b9df1c4050c15e2d4de4d52cc36a1cd97d/public/logo192.png
--------------------------------------------------------------------------------
/public/logo512.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/soulmachines/react-reference-ui-public/352672b9df1c4050c15e2d4de4d52cc36a1cd97d/public/logo512.png
--------------------------------------------------------------------------------
/public/manifest.json:
--------------------------------------------------------------------------------
1 | {
2 | "short_name": "React App",
3 | "name": "Create React App Sample",
4 | "icons": [
5 | {
6 | "src": "favicon.ico",
7 | "sizes": "64x64 32x32 24x24 16x16",
8 | "type": "image/x-icon"
9 | },
10 | {
11 | "src": "logo192.png",
12 | "type": "image/png",
13 | "sizes": "192x192"
14 | },
15 | {
16 | "src": "logo512.png",
17 | "type": "image/png",
18 | "sizes": "512x512"
19 | }
20 | ],
21 | "start_url": ".",
22 | "display": "standalone",
23 | "theme_color": "#000000",
24 | "background_color": "#ffffff"
25 | }
26 |
--------------------------------------------------------------------------------
/public/robots.txt:
--------------------------------------------------------------------------------
1 | # https://www.robotstxt.org/robotstxt.html
2 | User-agent: *
3 | Disallow:
4 |
--------------------------------------------------------------------------------
/src/Router.js:
--------------------------------------------------------------------------------
1 | import ReactGA from 'react-ga4';
2 | import React, { useEffect, useState } from 'react';
3 | import 'bootstrap/dist/css/bootstrap.min.css';
4 | import {
5 | BrowserRouter as Router,
6 | Switch,
7 | Route,
8 | withRouter,
9 | Link,
10 | } from 'react-router-dom';
11 | import { useSelector } from 'react-redux';
12 | import { XCircle } from 'react-bootstrap-icons';
13 | import DPChat from './routes/DPChat';
14 | import Landing from './routes/Landing';
15 | import Loading from './routes/Loading';
16 | import Feedback from './routes/FeedbackRoute';
17 | import ContentCardTest from './routes/ContentCardTest';
18 |
19 | // only init google analytics if a tracking ID is defined in env
20 | const { REACT_APP_GA_TRACKING_ID } = process.env;
21 | if (REACT_APP_GA_TRACKING_ID) {
22 | ReactGA.initialize(REACT_APP_GA_TRACKING_ID, { debug: true });
23 | console.log(`initializing google analytics with tracking ID ${REACT_APP_GA_TRACKING_ID}`);
24 | } else console.warn('no google analytics tracking ID provided!');
25 |
26 | // make GA aware of what pages people navigate to in react router
27 | const LinkGAtoRouter = withRouter(({ history }) => {
28 | history.listen((location) => {
29 | ReactGA.set({ page: location.pathname });
30 | });
31 | return null;
32 | });
33 |
34 | function App() {
35 | const { error } = useSelector(({ sm }) => ({ ...sm }));
36 | const [ignoreError, setIgnoreError] = useState(false);
37 | // every time error changes, set ignore error to false
38 | useEffect(() => setIgnoreError(false), [error]);
39 |
40 | // send SM session ID to google analytics when we connect
41 | if (REACT_APP_GA_TRACKING_ID) {
42 | const sessionID = useSelector(({ sm }) => sm.sessionID);
43 | useEffect(() => {
44 | if (sessionID !== '') ReactGA.gtag('event', 'sm_session_id', { sm_session_id: sessionID });
45 | }, [sessionID]);
46 | }
47 |
48 | return (
49 |
50 | { error && !ignoreError
51 | ? (
52 |
53 |
54 |
55 |
58 |
59 |
60 |
61 | Something has gone wrong!
62 |
63 |
64 | Sorry for the interruption.
65 | Feel free to start again, or give us some feedback to help us improve!
66 |
67 |
68 | Reconnect
69 | Return to Main Page
70 |
71 |
72 | {error.msg}
73 |
74 |
75 |
76 |
77 | ) : null}
78 |
79 |
80 |
81 |
82 |
83 |
84 |
85 |
86 |
87 |
88 |
89 |
90 |
91 | {/* / goes at the bottom */}
92 |
93 |
94 |
95 |
96 |
97 |
98 | );
99 | }
100 |
101 | export default App;
102 |
--------------------------------------------------------------------------------
/src/components/CameraPreview.js:
--------------------------------------------------------------------------------
1 | import React, { useEffect } from 'react';
2 | import { connect } from 'react-redux';
3 | import styled from 'styled-components';
4 | import PropTypes from 'prop-types';
5 | // import { CameraVideoOff } from 'react-bootstrap-icons';
6 | import { mediaStreamProxy } from '../proxyVideo';
7 |
8 | function CameraPreview({ connected, className, cameraOn }) {
9 | const videoRef = React.createRef();
10 | const stream = mediaStreamProxy.getUserMediaStream();
11 |
12 | useEffect(() => {
13 | if (stream !== null && mediaStreamProxy.videoOff === false) {
14 | // display webcam preview in video elem
15 | videoRef.current.srcObject = stream;
16 | }
17 | }, [connected]);
18 |
19 | // disable camera preview if camera is off
20 | // in the future, if smwebsdk supports toggling the camera on and off, remove this line
21 | if (cameraOn === false) return null;
22 |
23 | return (
24 |
25 | {/* NOTE: toggleVideo behavior is not supported by smwebsdk so it's not recommended */}
26 | {/*
39 | );
40 | }
41 |
42 | CameraPreview.propTypes = {
43 | connected: PropTypes.bool.isRequired,
44 | className: PropTypes.string.isRequired,
45 | cameraOn: PropTypes.bool.isRequired,
46 | };
47 |
48 | const StyledCameraPreview = styled(CameraPreview)`
49 | display: ${({ connected }) => (connected ? '' : 'none')};
50 | align-items: center;
51 | height: ${({ size }) => size || 4}rem;
52 |
53 | .video-button {
54 | display: flex;
55 | justify-content: center;
56 | align-items: center;
57 |
58 | padding: 0;
59 | height: ${({ size }) => size || 4}rem;
60 | aspect-ratio: ${({ cameraWidth, cameraHeight }) => cameraWidth / cameraHeight};
61 |
62 | border-radius: 3px;
63 | background: rgba(0,0,0,0.2);
64 | border: ${({ cameraOn }) => (cameraOn ? 'none' : '1px solid gray')};
65 | }
66 |
67 | video {
68 | height: ${({ size }) => size || 4}rem;
69 | transform: rotateY(180deg);
70 | aspect-ratio: ${({ cameraWidth, cameraHeight }) => cameraWidth / cameraHeight};
71 | border-radius: 3px;
72 | z-index: 20;
73 | }
74 | `;
75 |
76 | const mapStateToProps = ({ sm }) => ({
77 | connected: sm.connected,
78 | cameraOn: sm.cameraOn,
79 | cameraWidth: sm.cameraWidth,
80 | cameraHeight: sm.cameraHeight,
81 | });
82 |
83 | export default connect(mapStateToProps)(StyledCameraPreview);
84 |
--------------------------------------------------------------------------------
/src/components/Captions.js:
--------------------------------------------------------------------------------
1 | import React, { useState, useEffect } from 'react';
2 | import { connect } from 'react-redux';
3 | import styled from 'styled-components';
4 | import PropTypes from 'prop-types';
5 | import { syllable } from 'syllable';
6 |
7 | function Captions({
8 | speechState, lastPersonaUtterance, className, connected,
9 | }) {
10 | const [showCaptions, setShowCaptions] = useState(false);
11 | // if we have a very long response, we need to cycle the displayed content
12 | const [captionText, setCaptionText] = useState('');
13 | // keep track of when we first showed this caption. captions should be on screen min 1.5s
14 | const [captionStartTimestamp, setCaptionStartTimestamp] = useState();
15 | const [captionTimeout, setCaptionsTimeout] = useState();
16 | const minCaptionDuration = 1500;
17 |
18 | useEffect(() => {
19 | if (connected === false) setShowCaptions(false);
20 | else if (speechState === 'speaking') {
21 | // when a new utterance starts, show captions
22 | setShowCaptions(true);
23 | const sentences = lastPersonaUtterance.split('. ');
24 | // estimate how long each caption should be displayed based on # of syllables and punctuation
25 | const sentencesWithDurationEstimate = sentences.map((s) => {
26 | const millisPerSyllable = 210;
27 | const millisPerPunct = 330;
28 |
29 | const syllableCount = syllable(s);
30 |
31 | const regex = /[^\w ]/gm;
32 | const punctCount = [...s.matchAll(regex)].length;
33 |
34 | const durationEstimate = (syllableCount * millisPerSyllable)
35 | + (punctCount * millisPerPunct)
36 | // add one punct delay for the period that gets stripped when splitting the sentences
37 | + millisPerPunct;
38 | return { text: s, durationEstimate };
39 | });
40 |
41 | // recursively cycle through sentences on very long captions
42 | const displayCaption = (i) => {
43 | const { text, durationEstimate } = sentencesWithDurationEstimate[i];
44 | setCaptionText(text);
45 | if (sentencesWithDurationEstimate[i + 1]) {
46 | setTimeout(() => displayCaption(i + 1), durationEstimate);
47 | }
48 | };
49 | displayCaption(0);
50 |
51 | // record when we put captions on the screen
52 | setCaptionStartTimestamp(Date.now());
53 | // clear any previous timeout from previous captions.
54 | // this won't make the captions disappear, since we're overwriting the content
55 | clearTimeout(captionTimeout);
56 | } else {
57 | // when the utterance ends:
58 | const captionsDisplayedFor = Date.now() - captionStartTimestamp;
59 | // check to see if the captions have been displayed for the min. amount of time
60 | if (captionsDisplayedFor > minCaptionDuration) setShowCaptions(false);
61 | // if not, set a timeout to hide them when it has elapsed
62 | else {
63 | const newCaptionTimeout = setTimeout(() => {
64 | setShowCaptions(false);
65 | }, minCaptionDuration - captionsDisplayedFor);
66 | setCaptionsTimeout(newCaptionTimeout);
67 | }
68 | // sometimes we get blank input, hide that when it happens
69 | if (captionText === '') setShowCaptions(false);
70 | }
71 | }, [speechState, connected]);
72 |
73 | if (showCaptions === false) return null;
74 |
75 | return (
76 |
106 | {/* combine default tags and custom ones to display as one list */}
107 | {/* user can click on default tags to deselect and custom ones to edit */}
108 | {tagItems.map((t) => (
109 |
119 | ))}
120 |
121 |
122 |
123 |
Can you tell us more?
124 | {/* field for custom tags, limited to 20 chars */}
125 |