.github/workflows/test.yaml

@@ -1,18 +1,64 @@
 name: Tests
-on: [push]
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
 jobs:
+  lint:
+    name: Lint Go
+    runs-on: ubuntu-latest
+    steps:
+      - name: Install Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: 1.23
+
+      - name: Check out code
+        uses: actions/checkout@v4
+
+      - name: golangci-lint
+        uses: golangci/golangci-lint-action@v6
+        with:
+          version: v1.60
+          working-directory: ./api
+
   test:
-    name: Tests
+    name: Test Go
     runs-on: ubuntu-latest
     steps:
       - name: Install Go
         uses: actions/setup-go@v5
         with:
           go-version: 1.23
 
-      - name: Check out code into the Go module directory
+      - name: Check out code
         uses: actions/checkout@v4
 
       - name: Run Tests
         working-directory: ./api
         run: go test -v -bench=. -race ./...
+
+  lint-ui:
+    name: Lint UI
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node_version: [20]
+
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v4
+
+      - name: Use Node.js ${{ matrix.node_version }}
+        uses: actions/setup-node@v4
+        with:
+          node_version: ${{ matrix.node_version }}
+
+      - name: run CI
+        working-directory: ./ui
+        run: |
+          npm install
+          npm run lint

.gitignore

@@ -2,6 +2,7 @@ api/pkg/github/tmp/
 api/pkg/parser/tmp/
 api/postgres-data/
 api/sqlite3/
+api/uploads/
 ui/node_modules
 ui/.next/
 ui/out/
@@ -11,3 +12,4 @@ ui/yarn-debug.log*
 ui/yarn-error.log*
 .DS_Store
 .env
+tmp/

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Alex Pliutau
+Copyright (c) 2025 Alex Pliutau
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,10 +1,6 @@
-<p align="center" width="100%">
-	<img src="https://github.com/plutov/formulosity/blob/main/ui/public/logo_wide.png" height="100px">
-</p>
+<img src="https://github.com/plutov/formulosity/blob/main/ui/public/logo_wide.png" height="100px">
 
-<p align="center">
-Formulosity is a self-hosted app for building and deploying the surveys using code instead of traditional survey builders.
-</p>
+## Formulosity - self-hosted Surveys as Code platform.
 
 This approach offers a number of advantages, including:
 
@@ -14,13 +10,11 @@ This approach offers a number of advantages, including:
 
 **Formulosity** uses human-readable declarative language [YAML](https://en.wikipedia.org/wiki/YAML).
 
-<p align="center" width="100%">
-	<img src="https://github.com/plutov/formulosity/blob/main/ui/public/questions.png" height="250px">
-</p>
+<img src="https://github.com/plutov/formulosity/blob/main/ui/public/questions.png" height="250px">
 
 ## Features
 
-- [x] Management API
+- [x] API first
 - [x] Survey UI: for end users (respondents)
 - [x] Console UI: manage surveys
 - [x] YAML survey configuration
@@ -33,19 +27,10 @@ This approach offers a number of advantages, including:
 - [x] Different database options: SQLite and Postgres
 - [x] Continue where you left off
 - [x] Advanced validation rules
-- [x] Detect survey changes in real time
 - [x] Export responses in UI or via API
 - [ ] Advanced question types
 - [ ] Pipe answers into the following questions
 
-## See it in Action!
-
-<p align="center" width="100%">
-	<a href="https://formulosity.vercel.app/app">Admin Panel</a>
-</p>
-
-Note: use `user` / `pass` to login into the Console UI.
-
 ## Survey Structure
 
 Each directory in `SURVEYS_DIR` is a survey. You can configure the source of your surveys by setting different `SURVEYS_DIR` env var.
@@ -64,7 +49,7 @@ surveys/
     └── ...
 ```
 
-To get started, check out the `./surveys` folder with multiple examples.
+To get started, check out the `./api/surveys` folder with multiple examples.
 
 ## Survey Files
 
@@ -253,11 +238,26 @@ Presents a question where users can only answer "yes" or "no".
 ### Email
 
 Prompts user to enter their email
+
 ```yaml
 - type: email
   label: Please enter your email.
 ```
 
+### File
+
+Prompts user to upload their file based on a given formats and maximum upload size.
+
+```yaml
+- type: file
+  label: Upload a Berlin Image
+  validation:
+    formats:
+      - .jpg
+      - .png
+    max_size_bytes: 5*1024*1024 # 5 MB
+```
+
 ## Responses
 
 Responses can be shown in the UI and exported as a JSON. Alternatively you can use REST API to get survey resposnes:
@@ -282,24 +282,22 @@ Where `{SURVEY_ID}` id the UUID of a given survey.
 docker-compose up -d --build
 ```
 
-And you should be able to access the UI on http://localhost:3000 (default basic auth: `user:pass`).
+And you should be able to access the UI on [localhost:3000](http://localhost:3000) (default basic auth: `user:pass`).
 
 You can deploy individual services to any cloud provider or self host them.
 
 - Go backend. It's packaged as a Docker container and can be deployed anywhere.
 - Next.js frontend. It's also packaged as a Docker container, but also can be deployed to Vercel for example.
 - [Optional] Postgres database. You can use managed Postgres services or deploy it yourself.
 
-The demo service (links above) is deployed to Fly.io (Go, SQLite) and Vercel (Next.js) and are under the free tiers.
-
 ### Environment Variables
 
 API:
 
 - `DATABASE_TYPE` - `sqlite` or `postgres`
 - `DATABASE_URL` - Postgres or SQLite connection string
-- `LOG_LEVEL` - Log level, e.g. `info`
 - `SURVEYS_DIR` - Directory with surveys, e.g. `/root/surveys`. It's suggested to use mounted volume for this directory.
+- `UPLOADS_DIR` - Directory for uploading files from the survey forms.
 
 UI:
 

api/Dockerfile

@@ -1,4 +1,4 @@
-FROM golang:1.23-alpine AS builder
+FROM golang:1.24-alpine AS builder
 
 RUN apk add build-base
 
@@ -13,7 +13,7 @@ COPY ./cmd ./cmd
 COPY ./pkg ./pkg
 COPY ./migrations ./migrations
 COPY ./surveys ./surveys-examples
-RUN CGO_ENABLED=1 GOOS=linux go build -o api -tags enablecgo cmd/console-api/api.go
+RUN CGO_ENABLED=1 GOOS=linux go build -o api -tags enablecgo cmd/api/api.go
 
 FROM alpine:latest
 RUN apk --no-cache add ca-certificates tzdata bash

api/Makefile

@@ -1,3 +1,4 @@
+
 lint:
 	golangci-lint run
 

api/cmd/console-api/api.go → api/cmd/api/api.go

@@ -4,36 +4,31 @@ import (
 	"os"
 
 	controllers "github.com/plutov/formulosity/api/pkg/controllers"
-	"github.com/plutov/formulosity/api/pkg/log"
 	"github.com/plutov/formulosity/api/pkg/services"
 	"github.com/plutov/formulosity/api/pkg/surveys"
 )
 
 func main() {
-	log.Named("console-api")
-	logLevel := "info"
-	if os.Getenv("LOG_LEVEL") != "" {
-		logLevel = os.Getenv("LOG_LEVEL")
-	}
-	log.SetLogLevel(logLevel)
-
 	svc, err := services.InitServices()
 	if err != nil {
-		log.WithError(err).Fatal("unable to init dependencies")
+		svc.Logger.Error("unable to init dependencies", "err", err)
+		os.Exit(1)
 	}
 
 	if err := surveys.SyncSurveys(svc); err != nil {
-		log.WithError(err).Fatal("unable to sync surveys")
+		svc.Logger.Error("unable to sync surveys", "err", err)
+		os.Exit(1)
 	}
 
 	handler := controllers.NewHandler(svc)
 	if err != nil {
-		log.WithError(err).Fatal("unable to start server")
+		svc.Logger.Error("unable to start server", "err", err)
+		os.Exit(1)
 	}
 
 	r := controllers.NewRouter(handler)
 
 	if err := r.Start(":8080"); err != nil {
-		log.WithError(err).Fatal("shutting down the server")
+		svc.Logger.Info("shutting down the server", "err", err)
 	}
 }

api/go.mod

@@ -1,6 +1,6 @@
 module github.com/plutov/formulosity/api
 
-go 1.23
+go 1.24
 
 require (
 	github.com/fsnotify/fsnotify v1.7.0
@@ -11,8 +11,7 @@ require (
 	github.com/matoous/go-nanoid/v2 v2.0.0
 	github.com/mattn/go-sqlite3 v1.14.22
 	github.com/microcosm-cc/bluemonday v1.0.27
-	github.com/stretchr/testify v1.8.4
-	go.uber.org/zap v1.26.0
+	github.com/stretchr/testify v1.9.0
 	gopkg.in/yaml.v3 v3.0.1
 )
 
@@ -24,19 +23,22 @@ require (
 	github.com/gorilla/css v1.0.1 // indirect
 	github.com/hashicorp/errwrap v1.1.0 // indirect
 	github.com/hashicorp/go-multierror v1.1.1 // indirect
+	github.com/kr/pretty v0.3.1 // indirect
 	github.com/labstack/gommon v0.4.2 // indirect
 	github.com/lib/pq v1.10.9 // indirect
 	github.com/mattn/go-colorable v0.1.13 // indirect
 	github.com/mattn/go-isatty v0.0.20 // indirect
 	github.com/pmezard/go-difflib v1.0.0 // indirect
-	github.com/stretchr/objx v0.5.0 // indirect
+	github.com/rogpeppe/go-internal v1.12.0 // indirect
+	github.com/stretchr/objx v0.5.2 // indirect
 	github.com/valyala/bytebufferpool v1.0.0 // indirect
 	github.com/valyala/fasttemplate v1.2.2 // indirect
 	go.uber.org/atomic v1.7.0 // indirect
-	go.uber.org/multierr v1.10.0 // indirect
-	golang.org/x/crypto v0.24.0 // indirect
-	golang.org/x/net v0.26.0 // indirect
-	golang.org/x/sys v0.21.0 // indirect
-	golang.org/x/text v0.16.0 // indirect
-	golang.org/x/time v0.5.0 // indirect
+	golang.org/x/crypto v0.27.0 // indirect
+	golang.org/x/net v0.29.0 // indirect
+	golang.org/x/sys v0.25.0 // indirect
+	golang.org/x/text v0.18.0 // indirect
+	golang.org/x/time v0.6.0 // indirect
+	golang.org/x/tools v0.25.0 // indirect
+	gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c // indirect
 )