Zero-cost contact forms for your landing page - powered by GitHub Issues.

Every time someone submits your contact form, you receive an automatic email notification. No monthly fees, no external database.

GitForms = Free alternative to Typeform, Tally, and FormSpree

• ✅ 100% Configurable without code (JSON files)
• ✅ Automatic email notifications for every submission
• ✅ Multilingual (IT/EN) with auto browser language detection
• ✅ Customizable styling (colors, borders, shadows)
• ✅ Customizable text (labels, messages, buttons)
• ✅ Next.js 14 with App Router
• ✅ TypeScript
• ✅ Tailwind CSS
• ✅ Deploy anywhere (Vercel, Netlify, Railway, Docker, AWS...)
• ✅ Completely free

User fills form → Data saved to GitHub Issue → Email notification sent

# 1. Clone
git clone https://github.com/Luigigreco/gitforms.git
cd gitforms

# 2. Install
npm install

# 3. Configure
cp .env.example .env.local
# Edit .env.local with your GITHUB_TOKEN and GITHUB_REPO

# 4. Start
npm run dev

Open http://localhost:3000

File: config/theme.json

{
  "colors": {
    "primary": {
      "DEFAULT": "#10b981",  // Green instead of blue
      "hover": "#059669",
      "ring": "#34d399"
    }
  }
}

Popular colors:

• Purple: #8b5cf6, #7c3aed, #a78bfa
• Orange: #f97316, #ea580c, #fb923c
• Pink: #ec4899, #db2777, #f472b6

File: config/translations.json

{
  "it": {
    "title": "Richiedi Informazioni",  // Change "Contattaci"
    "fields": {
      "company": "Società"  // Change "Azienda" to "Società"
    },
    "buttons": {
      "submit": "Richiedi Contatto"  // Change button
    }
  }
}

File: .env.local

NEXT_PUBLIC_DEFAULT_LOCALE=it   # Force Italian
# or
NEXT_PUBLIC_DEFAULT_LOCALE=en   # Force English
# or remove for auto-detection

File: config/translations.json

{
  "it": { ... },
  "en": { ... },
  "fr": {
    "title": "Contactez-nous",
    "subtitle": "Remplissez le formulaire...",
    "fields": {
      "firstName": "Prénom",
      "lastName": "Nom",
      "email": "Email",
      "company": "Entreprise",
      "message": "Message"
    }
  }
}

Then update src/app/translations.ts:

export type Locale = 'it' | 'en' | 'fr'

Edit only these 3 files = complete customization!

All fields are required:

• First Name
• Last Name
• Email
• Company
• Message

curl -X POST http://localhost:3000/api/contact \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "Mario",
    "lastName": "Rossi",
    "email": "mario@example.com",
    "company": "ACME",
    "message": "Ciao"
  }'

Easiest for Next.js - 2 clicks, zero configuration.

# Install Vercel CLI (optional)
npm i -g vercel

# Deploy
vercel

Or via Dashboard:

1. Push to GitHub
2. Import on vercel.com
3. Add environment variables:
   • GITHUB_TOKEN
   • GITHUB_REPO
   • NEXT_PUBLIC_DEFAULT_LOCALE (optional)
4. Auto deploy!

Free Tier: Unlimited for personal projects

Great Vercel alternative - 2 clicks, great free tier.

1. Push to GitHub
2. Import on netlify.com
3. Build settings:
   • Build command: npm run build
   • Publish directory: .next
4. Environment variables:
   • GITHUB_TOKEN
   • GITHUB_REPO
   • NEXT_PUBLIC_DEFAULT_LOCALE (optional)
5. Deploy!

Free Tier: 100GB bandwidth/month

Fast deploy with included databases - 3 clicks, good free tier.

1. Push to GitHub
2. Go to railway.app
3. New Project → Deploy from GitHub
4. Add environment variables (Dashboard → Variables)
5. Railway auto-detects Next.js and deploys

Free Tier: $5 credit/month (~500h runtime)

Alternative with free tier - Auto-sleep after inactivity.

1. Push to GitHub
2. New Web Service on render.com
3. Connect repository
4. Settings:
   • Build Command: npm install && npm run build
   • Start Command: npm start
5. Environment variables:
   • GITHUB_TOKEN
   • GITHUB_REPO

Free Tier: Unlimited (with auto-sleep)

Full control - Deploy on any VPS/cloud.

# Build
docker build -t gitforms .

# Run
docker run -p 3000:3000 \
  -e GITHUB_TOKEN=your_token \
  -e GITHUB_REPO=your_repo \
  gitforms

With Docker Compose:

# docker-compose.yml
version: '3.8'
services:
  app:
    build: .
    ports:
      - "3000:3000"
    environment:
      - GITHUB_TOKEN=${GITHUB_TOKEN}
      - GITHUB_REPO=${GITHUB_REPO}
      - NEXT_PUBLIC_DEFAULT_LOCALE=it
    restart: unless-stopped

docker-compose up -d

Cost: VPS from €5/month (DigitalOcean, Hetzner, Linode)

Enterprise deployment - Auto-scaling, global CDN.

1. Push to GitHub
2. AWS Console → Amplify → New App
3. Connect repository
4. Build settings (auto-detected):

   version: 1
   frontend:
     phases:
       preBuild:
         commands:
           - npm install
       build:
         commands:
           - npm run build
     artifacts:
       baseDirectory: .next
       files:
         - '**/*'
     cache:
       paths:
         - node_modules/**/*

5. Environment variables:
   • GITHUB_TOKEN
   • GITHUB_REPO

Free Tier: 1000 build minutes/month, 15GB storage

Recommendation: Vercel or Netlify for guaranteed €0/month.

// config/translations.json
{
  "it": {
    "title": "Richiedi una Demo",
    "subtitle": "Compila il form per una demo personalizzata",
    "buttons": { "submit": "Richiedi Demo" }
  }
}

// config/theme.json
{ "colors": { "primary": { "DEFAULT": "#1e3a8a" } } }  // Corporate blue

// config/translations.json
{
  "it": {
    "title": "Hai Domande?",
    "fields": { "company": "Settore" },
    "buttons": { "submit": "Invia Richiesta" }
  }
}

// config/theme.json
{ "colors": { "primary": { "DEFAULT": "#dc2626" } } }  // Sales red

• Deployment Guide: See DEPLOYMENT.md for detailed platform guides
• Testing Guide: See TESTING.md for API testing
• Monetization Ideas: See MONETIZATION.md for revenue strategies
• SEO Setup: See SETUP_DISCOVERABILITY.md for marketing

CC-BY-NC-SA-4.0 (Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International)

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

Key Terms:

• ✅ Attribution - Credit must be given to Luigi Greco
• ❌ NonCommercial - No commercial use without permission
• ✅ ShareAlike - Derivatives must use the same license

See LICENSE file for full legal text.

https://github.com/Luigigreco/gitforms

Made with ❤️ by Luigi Greco | Star us on GitHub ⭐