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 ⭐