Self-Host SchemaMap

Quick Deploy Options

Vercel (Recommended)

One-click deploy with automatic CI/CD

Deploy to Vercel

Cloudflare Pages

Global edge network deployment

Deploy to Cloudflare

Manual Installation

Prerequisites

Node.js 18+ and npm/yarn/pnpm
Git
A hosting platform (Vercel, Netlify, Cloudflare Pages, or any static host)

Step 1: Clone the Repository

git clone https://github.com/codebruinc/schemamap.git
cd schemamap

Step 2: Install Dependencies

npm install
# or
yarn install
# or
pnpm install

Step 3: Build the Application

npm run build
# This creates an optimized production build in the 'out' directory

Step 4: Deploy the Static Files

The out directory contains static HTML/CSS/JS files that can be hosted anywhere:

Option A: Local Preview

npx serve -s out

Option B: Deploy to Nginx

# Copy files to your web root
cp -r out/* /var/www/html/

# Nginx config
location / {
  try_files $uri $uri/ /index.html;
}

Option C: Docker Container

FROM nginx:alpine
COPY out /usr/share/nginx/html
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

Configuration Options

Environment Variables

For optional features like Stripe payments (Large File Pass):

# .env.local (optional - only if enabling payments)
STRIPE_SECRET_KEY=sk_test_...
STRIPE_PRICE_ID=price_...
STRIPE_WEBHOOK_SECRET=whsec_...
ENABLE_STRIPE_PAYMENTS=true

Customization

Branding: Edit app/layout.tsx for site title and metadata
Limits: Adjust row limits in app/map/MapperComponent.tsx
Templates: Add new schemas in packages/engine/src/templates/

Security Considerations

⚠️ Important Security Notes

• All CSV processing happens in the browser - no server-side processing
• Configure CSP headers to prevent XSS attacks
• Use HTTPS in production
• Review and audit dependencies regularly
• Consider adding authentication if needed for your use case

Support

📚 Documentation

Check our GitHub README for detailed docs

View Documentation

🐛 Issues & Features

Report bugs or request features

GitHub Issues

License

SchemaMap is MIT licensed. You're free to use, modify, and distribute it for any purpose.

🔒 Maximum Privacy