| name | maintainx-local-dev-loop |
| description | Set up a local development loop for MaintainX integration development.
Use when configuring dev environment, testing API calls locally,
or setting up a sandbox workflow for MaintainX.
Trigger with phrases like "maintainx dev setup", "maintainx local",
"maintainx development environment", "maintainx testing setup".
|
| allowed-tools | Read, Write, Edit, Bash(npm:*), Bash(node:*), Bash(docker:*) |
| version | 1.11.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["saas","maintainx","api","testing","workflow"] |
| compatibility | Designed for Claude Code, also compatible with Codex and OpenClaw |
MaintainX Local Dev Loop
Overview
Set up an efficient local development workflow for building and testing MaintainX integrations with hot reload, mock servers, and automated testing.
Prerequisites
- Completed
maintainx-install-auth setup
- Node.js 18+ installed
MAINTAINX_API_KEY environment variable set
Instructions
Step 1: Initialize TypeScript Project
mkdir maintainx-integration && cd maintainx-integration
npm init -y
npm install axios dotenv
npm install -D typescript tsx vitest @types/node
npx tsc --init --target ES2022 --module NodeNext --moduleResolution nodenext --outDir dist
Create tsconfig.json paths:
{
"compilerOptions": {
"target": "ES2022",
"module": "NodeNext",
"moduleResolution": "nodenext",
"outDir": "dist",
"strict": true,
"esModuleInterop": true
},
"include": ["src/**/*"]
}
Step 2: Project Structure
