ACUL documentation does not line up with linked GitHub repository

Get Help
,
1

I am attempting to evaluate ACUL for our use cases, but

  • The Auth0 ACUL JS SDK Quickstart article mentions an auth0-acul-react-boilerplate folder that doesn’t exist.
  • The start of the App.tsx file iin the Quickstart does not look the same as it does in GitHub.
  • The GitHub documentation contradicts the Quickstart article.

As a result, I am confused on how to leverage the documentation to start testing with ACUL.

2

Hello!
I am facing the same issue. Please inform if you get any solution.

4

Hi Team!

Welcome to the Auth0 Community!

Thank you for the question. Let me go to our Product team to gather some answers, and I will get back to you as soon as I have more details.

Thank you, and I appreciate your patience!
Dawid

5

FWIW, I was able to get a very simple POC of the ACUL functionality run to test it out. This helped me demystify it and test out the flow.

Steps for simple ACUL POC
1- Create a new React project
npm create vite@latest

2- install a few more dependencies
npm install @auth0/auth0-acul-js
npm install tailwindcss @tailwindcss/postcss postcss

3-Create a simple form that has the required fields for the screen you are customizing. EG, for the signup-password screen, I’m just using this:
function App() { return ( <> <div>HELLO</div> <form action={window.location.href} method="post"> Username <input type="text" name="username" /> <br/> Password <input type="text" name="password" /> <br/> Favorite Color <input type="text" name="favoriteColor" /> <input type="submit" value="Submit" /> </form> </> ) } export default App;

Important: submit form to the same origin

4-Build the app and serve locally from the ./dist directory
note: you’ll probably need an ssl cert and to tweak the cors settings

5- Tell Auth0 you’re using an advanced screen
Patch the json below here:
[managementApiUri]/api/v2/prompts/signup-password/screen/signup-password/rendering

{ "rendering_mode": "advanced", "head_tags": [ { "tag": "script", "attributes": { "src": "https://192.168.1.39:8080/assets/[YOUR FILE NAME].js", "defer": true } } ] }

That’s basically it. Note, I’m not even using the ACUL JDK in this example. Just submitting a form with the correct fields.

Also, I’m unable to access the form data in the pre-user-registration action, as the documentation indicates you should. If anyone has more lock with this, please let me know.