forms

Intranet Forms System

A simple, fast, and secure form builder and response collection system built entirely on a flat-file backend using native PHP.

Features

• No Database Required: Stores all forms and responses securely in JSON files.
• Drag-and-Drop Builder: Quickly assemble forms using Text inputs, Text areas, Single-Choice (radio), Multiple-Choice (checkbox), and Dropdown elements powered by Sortable.js.
• Seamless Answering: Forms cache user credentials (Name/Email) automatically per local session, enabling rapid workflows on shared terminals or multiple submissions.
• Admin Viewer: Share the randomly generated Admin secret link to view responses aggregated in a responsive table.
• Email Notifications: Triggers notification emails using native mail() handlers across creations and form resolutions.
• Intranet Style System: A strictly responsive, dark-mode styling conforming to universal intranet docs/style_system.md standards.

Installation Instructions

1. Clone or copy the directory to your target web host. Any shared hosting serving PHP 7.4+ is supported out of the box.
2. Ensure File Permissions: Ensure the web server application has write permissions over the data/forms/ and data/answers/ directories.
3. Access index.php from your browser to begin creating forms.

Security Note: The data folder contains a restrictive .htaccess file. Do not remove it, as it locks direct browser access to raw JSON files storing your submission metrics.

Documentation

For AI agents and developers scaling the infrastructure, refer to the /docs folder:

• docs/ai_spec.md: Agent-first architecture specifications.
• docs/implementation_plan.md: The original architecture implementation plan context.
• docs/style_system.md: Canonical branding and style rules.