Appfolio deploy integration

Skill jeremylongshore/claude-code-plugins-plus-skills/plugins/saas-packs/appfolio-pack/skills/appfolio-deploy-integration

425 plugins, 2,810 skills, 200 agents for Claude Code. Open-source marketplace at tonsofskills.com with the ccpi CLI package manager.

Install

npx -y skills add jeremylongshore/claude-code-plugins-plus-skills --skill appfolio-deploy-integration

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

'Deploy AppFolio integration service to cloud infrastructure.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

3.6 KB, 852 tokens by cl100k_base, as published. Nobody here has run it

AppFolio Deploy Integration

Overview

Deploy a containerized AppFolio property management integration service with Docker. This skill covers building a production-ready image that connects to the AppFolio Stack API for managing properties, tenants, and work orders. Includes environment configuration for multi-property setups, health checks that verify API connectivity, and rolling update strategies for zero-downtime deployments across your property portfolio.

Docker Configuration

FROM node:20-slim AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY tsconfig.json ./
COPY src/ ./src/
RUN npm run build

FROM node:20-slim
RUN addgroup --system app && adduser --system --ingroup app app
WORKDIR /app
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules
COPY package*.json ./
USER app
EXPOSE 3000
HEALTHCHECK --interval=30s --timeout=5s --retries=3 \
  CMD curl -f http://localhost:3000/health || exit 1
CMD ["node", "dist/index.js"]

Environment Variables

export APPFOLIO_API_KEY="af_live_xxxxxxxxxxxx"
export APPFOLIO_BASE_URL="https://your-company.appfolio.com/api/v1"
export APPFOLIO_COMPANY_ID="your-company"
export LOG_LEVEL="info"
export PORT="3000"
export NODE_ENV="production"

Health Check Endpoint

import express from 'express';

const app = express();

app.get('/health', async (req, res) => {
  try {
    const response = await fetch(`${process.env.APPFOLIO_BASE_URL}/properties`, {
      headers: { 'Authorization': `Bearer ${process.env.APPFOLIO_API_KEY}` },
    });
    if (!response.ok) throw new Error(`AppFolio API returned ${response.status}`);
    res.json({ status: 'healthy', service: 'appfolio-integration', timestamp: new Date().toISOString() });
  } catch (error) {
    res.status(503).json({ status: 'unhealthy', error: (error as Error).message });
  }
});

Deployment Steps

Step 1: Build

docker build -t appfolio-integration:latest .

Step 2: Run

docker run -d --name appfolio-integration \
  -p 3000:3000 \
  -e APPFOLIO_API_KEY -e APPFOLIO_BASE_URL -e APPFOLIO_COMPANY_ID \
  appfolio-integration:latest

Step 3: Verify

curl -s http://localhost:3000/health | jq .

Step 4: Rolling Update

docker build -t appfolio-integration:v2 . && \
docker stop appfolio-integration && \
docker rm appfolio-integration && \
docker run -d --name appfolio-integration -p 3000:3000 \
  -e APPFOLIO_API_KEY -e APPFOLIO_BASE_URL -e APPFOLIO_COMPANY_ID \
  appfolio-integration:v2

Error Handling

Issue	Cause	Fix
`401 Unauthorized`	Invalid or expired API key	Regenerate key in AppFolio Stack Partner portal
`403 Forbidden`	Missing property access scope	Request additional scopes from AppFolio admin
`404 Not Found`	Incorrect base URL or company ID	Verify `APPFOLIO_BASE_URL` matches your subdomain
`429 Rate Limited`	Too many requests per minute	Implement exponential backoff with 60s window
Container exits immediately	Missing required env vars	Ensure all env vars are set before starting

Resources

AppFolio Stack APIs

Next Steps

See appfolio-webhooks-events.