twill-ai-ui

Repo: Twill-AI/twill-ai-ui
Language: TypeScript
Description: React Frontend codebase for Twill AI.

README

Twill Front-end

NextJS app. Exported as static website.

Getting Started

  1. Install NPM or BUN. Use NodeJS v20+. Below examples with npm, it is used in CI.
  2. Run npm install.
  3. Copy template.config.json into public folder with name “config.json” to work with staging environment locally.
  4. Run with npm dev.
  5. Open http://localhost:3000 with your browser to see the result.
  6. (only for “run prod” command) install Python v3+ under “python3” command (usually pre-installed on Unix/Mac).

Static Export

Note that front-end app is served in production as static website on Azure Front Door. It means we can’t use dynamic routes or API routes because we don’t have NextJS server-side.

To try a static export, run npm run prod, note that it starts in ~1 minute and doesn’t support live reload. So not so convenient for development.

Deploy

Merge into “main” branch. CI would call next build to make static files and move to “versions” blob plus would deploy to “staging” GH Pages https://fluffy-winner-lm32gle.pages.github.io

Deployment to Azure Front Door (staging and production) is implemented via https://github.com/Twill-AI/twill-iac

Recent Open Issues

  • #1127 Tickets Dashboard
  • #937 Master can Invite merchant or link to Luqra/EMS
  • #1140 merchant creation UX change
  • #779 Generate merchant application in the background.
  • #1149 fix: add *.twill.biz to CSP connect-src for local dev tunnels
  • #1130 Updates the fees and pricing section
  • #1137 [bug] User not loading as Me
  • #572 Design a rate recommendation system (vs. potential commission)
  • #1110 Allow signature via docuseal
  • #1109 Select processor

Patterns & Notes

Dash adds architecture notes here as work progresses