Add SEARCH_TERM_MIN_LENGTH configuration for minimum search term length

- Add SEARCH_TERM_MIN_LENGTH environment variable (default: 0)
- Implement minimum length validation in search functionality
- Update Docker configurations and documentation
- Add changelog entry for version 1.0.7

Author: codebude

CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to **takeCode** will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.7] - 2025-01-09
+
+### Added
+- **Minimum Search Term Length**: Added `SEARCH_TERM_MIN_LENGTH` environment variable to set minimum character requirement for search terms (default: 0, no minimum)
+
+### Technical Details
+- Added configurable minimum search term length with validation and user feedback
+- Updated configuration system to support new environment variable across all deployment methods
+- Enhanced search input handler to enforce minimum length requirements
+
 ## [1.0.6] - 2025-09-20
 
 ### Fixed

README.md

@@ -131,6 +131,29 @@ environment:
 # No environment variable needed
 ```
 
+#### SEARCH_TERM_MIN_LENGTH
+
+Controls the minimum length of search terms required to perform a search.
+
+- **Default**: `1` (match from first character on)
+- **Range**: `1` to `9007199254740991` (JavaScript's `Number.MAX_SAFE_INTEGER`)
+- **Behavior**: If the search term is shorter than this search will not be executed
+
+**Examples:**
+
+```yaml
+# Require at least 2 characters for search
+environment:
+  - SEARCH_TERM_MIN_LENGTH=2
+
+# Require at least 3 characters for search
+environment:
+  - SEARCH_TERM_MIN_LENGTH=3
+
+# No minimum length (default)
+# No environment variable needed
+```
+
 ### Manual Docker Run
 
 ```bash

docker-compose-dev.yml

@@ -8,4 +8,5 @@ services:
       - ./db.json:/data/db.json:ro
     environment:
       - SEARCH_HIGHLIGHT_LIMIT=10
+      - SEARCH_TERM_MIN_LENGTH=2
     restart: unless-stopped

docker-compose.yml

@@ -8,4 +8,5 @@ services:
       - ./db.json:/data/db.json:ro
     #environment:
     #  - SEARCH_HIGHLIGHT_LIMIT=3
+    #  - SEARCH_TERM_MIN_LENGTH=1
     restart: unless-stopped

entrypoint.sh

@@ -1,6 +1,6 @@
 #!/bin/sh
 # Substitute environment variables in index.html
-envsubst '${SEARCH_HIGHLIGHT_LIMIT}' < /usr/share/nginx/html/index.html > /usr/share/nginx/html/index.html.tmp
+envsubst '${SEARCH_HIGHLIGHT_LIMIT} ${SEARCH_TERM_MIN_LENGTH}' < /usr/share/nginx/html/index.html > /usr/share/nginx/html/index.html.tmp
 mv /usr/share/nginx/html/index.html.tmp /usr/share/nginx/html/index.html
 
 # Start nginx

nginx.conf

@@ -1,5 +1,6 @@
 # Enable environment variable access
 env SEARCH_HIGHLIGHT_LIMIT;
+env SEARCH_TERM_MIN_LENGTH;
 
 events {
     worker_connections 1024;

public/index.html

@@ -70,7 +70,8 @@ <h1 class="text-2xl font-bold truncate">takeCode</h1>
     <script>
         // Set global config from environment variables
         window.TAKECODE_CONFIG = {
-            SEARCH_HIGHLIGHT_LIMIT: parseInt('${SEARCH_HIGHLIGHT_LIMIT}') || 3
+            SEARCH_HIGHLIGHT_LIMIT: parseInt('${SEARCH_HIGHLIGHT_LIMIT}') || 3,
+            SEARCH_TERM_MIN_LENGTH: Math.max(1, parseInt('${SEARCH_TERM_MIN_LENGTH}') || 1)
         };
 
         // Keyboard shortcuts

public/js/app.js

@@ -220,6 +220,7 @@ document.addEventListener('DOMContentLoaded', () => {
 
         const query = e.target.value;
         const activeSnippets = dbData.snippets.filter(s => !s.isDeleted);
+        const minLength = window.TAKECODE_CONFIG?.SEARCH_TERM_MIN_LENGTH ?? 1;
 
         if (query.trim() === '') {
             // No search query - show all snippets with first tab active and no highlighting
@@ -236,6 +237,22 @@ document.addEventListener('DOMContentLoaded', () => {
 
             // Hide search info bar when no search is active
             searchInfoBar.classList.add('hidden');
+        } else if (query.trim().length < minLength) {
+            // Search term too short - show all snippets without highlighting
+            currentSnippets = activeSnippets.map(snippet => ({
+                ...snippet,
+                activeTabIndex: 0, // Always show first tab when no search
+                highlightedContent: snippet.content.map(content => ({
+                    ...content,
+                    highlightedValue: content.value // No highlighting
+                })),
+                highlightedName: snippet.name,
+                highlightedDescription: snippet.description
+            }));
+            
+            // Show message about minimum length
+            searchInfoBar.innerHTML = `Search term too short (minimum ${minLength} characters)`;
+            searchInfoBar.classList.remove('hidden');
         } else {
             // Filter snippets and determine which tab should be active
             const filteredSnippets = activeSnippets.filter(snippet => {