tephlon/web-form-server repository overview

git clone https://github.com/TephlonDude/web-form-server.git
cd web-form-server
docker compose up -d

{
  "form": {
    "title": "Contact Us",
    "submit_label": "Send Message",
    "sections": [
      {
        "id": "contact",
        "title": "Your Details",
        "fields": [
          {
            "id": "full_name",
            "type": "text",
            "label": "Full Name",
            "required": true
          }
        ]
      }
    ]
  }
}

{
  "form": {
    "title": "Registration",
    "submit_label": "Complete Registration",
    "pages": [
      {
        "id": "step1",
        "title": "Personal Info",
        "description": "Tell us about yourself.",
        "sections": [
          {
            "id": "basics",
            "title": "Basic Details",
            "fields": [
              {
                "id": "full_name",
                "type": "text",
                "label": "Full Name"
              }
            ]
          }
        ]
      },
      {
        "id": "step2",
        "title": "Preferences",
        "sections": [
          {
            "id": "prefs",
            "title": "Your Preferences",
            "fields": [
              {
                "id": "newsletter",
                "type": "checkbox",
                "label": "Subscribe to newsletter",
                "value": "yes"
              }
            ]
          }
        ]
      }
    ]
  }
}

{
  "id": "full_name",
  "type": "text",
  "label": "Full Name",
  "required": true,
  "placeholder": "Jane Doe",
  "pattern": "[A-Za-z ]+",
  "minlength": 2,
  "maxlength": 100,
  "autocomplete": "name"
}

{
  "id": "age",
  "type": "number",
  "label": "Age",
  "min": 0,
  "max": 120,
  "step": 1
}

{
  "id": "rating",
  "type": "range",
  "label": "Satisfaction (1–10)",
  "min": 1,
  "max": 10,
  "step": 1,
  "value": "5"
}

{
  "id": "birth_date",
  "type": "date",
  "label": "Date of Birth",
  "min": "1900-01-01",
  "max": "2010-12-31"
}

{
  "id": "appt_time",
  "type": "time",
  "label": "Appointment Time",
  "min": "08:00",
  "max": "17:00",
  "step": 900
}

{
  "id": "meeting",
  "type": "datetime-local",
  "label": "Meeting Date & Time",
  "min": "2026-01-01T08:00",
  "max": "2027-12-31T17:00"
}

{
  "id": "brand_color",
  "type": "color",
  "label": "Brand Color",
  "value": "#3498db"
}

{
  "id": "comments",
  "type": "textarea",
  "label": "Additional Comments",
  "placeholder": "Enter your thoughts here…",
  "rows": 6,
  "cols": 60,
  "maxlength": 2000
}

{
  "id": "country",
  "type": "select",
  "label": "Country",
  "required": true,
  "placeholder": "-- Select a country --",
  "options": [
    { "label": "United States", "value": "us" },
    { "label": "Canada",        "value": "ca", "selected": true },
    { "label": "Other",         "value": "other" }
  ]
}

{
  "id": "languages",
  "type": "select",
  "label": "Languages Spoken",
  "multiple": true,
  "size": 5,
  "options": [
    { "label": "English", "value": "en", "selected": true },
    { "label": "French",  "value": "fr" },
    { "label": "Spanish", "value": "es" }
  ]
}

{
  "id": "plan",
  "type": "radio",
  "label": "Choose Plan",
  "required": true,
  "options": [
    { "label": "Free",       "value": "free" },
    { "label": "Pro",        "value": "pro",        "checked": true },
    { "label": "Enterprise", "value": "enterprise", "disabled": true }
  ]
}

{
  "id": "agree_terms",
  "type": "checkbox",
  "label": "I agree to the Terms of Service",
  "required": true,
  "value": "yes"
}

{
  "id": "interests",
  "type": "checkbox_group",
  "label": "Interests",
  "options": [
    { "label": "Technology", "value": "tech",    "checked": true },
    { "label": "Sports",     "value": "sports" },
    { "label": "Music",      "value": "music",   "disabled": true }
  ]
}

{
  "id": "resume",
  "type": "file",
  "label": "Upload Resume",
  "accept": ".pdf,.doc,.docx"
}

{
  "id": "photos",
  "type": "file",
  "label": "Upload Photos",
  "accept": "image/*",
  "multiple": true
}

{
  "id": "form_version",
  "type": "hidden",
  "value": "2.0.0"
}

{
  "id": "preview_btn",
  "type": "button",
  "value": "Preview",
  "css_class": "btn-secondary",
  "title": "Preview before submitting"
}

/* Page wrapper */
body, .form-container {}

/* Section grouping */
fieldset, legend {}

/* Per-field wrapper (all types) */
.field-group, .field-group label {}

/* Input elements */
input[type="text"], input[type="email"], textarea, select {}

/* Choice groups */
.radio-group .radio-option {}
.checkbox-group .checkbox-option {}
.checkbox-single {}

/* Range slider + live value */
input[type="range"], output {}

/* Required asterisk */
.required {}

/* Submit area */
.form-actions {}
button[type="submit"], button[type="reset"] {}

/* Browser validation states */
input:invalid, input:valid {}

/* Multi-page navigation */
.page-steps, .step-item, .step-bubble, .step-label {}
.progress-bar, .progress-fill {}
.page-actions, .btn-next, .btn-prev {}

environment:
  FORM_FILE: /web-config/my-form.json
  CSS_FILE:  /web-config/my-form.css
  SAVE_SUBMISSIONS: "true"

docker compose up -d --build   # Build and start
docker compose logs -f         # Follow logs
docker compose down            # Stop

HOST_PORT=9000 docker compose up -d

./deploy.sh             # Build + transfer image + restart on server
./deploy.sh --rebuild   # Force full rebuild (no cache)

Web Form Server/
├── main.go               # HTTP server, route registration
├── form_loader.go        # JSON parsing, validation, struct definitions
├── renderer.go           # HTML rendering for all field types
├── submission.go         # Submission logging and JSON file output
├── config_handler.go     # /config route handlers
├── go.mod                # Go module definition
├── Dockerfile            # Multi-stage build (builder + alpine runtime)
├── docker-compose.yml    # Service definition with volume mounts
├── deploy.sh             # Build-and-deploy script for remote server
├── CLAUDE.md             # Claude Code project context
├── templates/
│   ├── form.html         # Form rendering template (multi + single page)
│   ├── submitted.html    # Post-submission confirmation page
│   └── config.html       # Visual config editor page
├── web-config/
│   ├── example.form.json # Demo form covering all field types
│   └── example.form.css  # Default stylesheet
└── data/
    └── submissions/      # Saved submission JSON files (volume-mounted)

go mod tidy                      # Fetch dependencies
go build -o web-form-server .    # Build binary
go vet ./...                     # Static analysis
./web-form-server                # Run (set FORM_FILE and CSS_FILE env vars)