Skip to content

Vyas106/FormLab

Repository files navigation

FormLab

FormLab Logo

Open Source Form Builder for the Modern Web

MIT License Next.js Prisma PostgreSQL Clerk

Demo β€’ Documentation β€’ Contributing β€’ Support

πŸš€ Quick Start

# Clone the repository
git clone https://github.com/vyasvishal/formlab.git

# Navigate to the project directory
cd formlab

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env.local

# Start the development server
npm run dev

Visit http://localhost:3000 to see FormLab in action!

πŸ”‘ Environment Variables

Create a .env.local file with the following variables:

# Authentication
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key
CLERK_SECRET_KEY=your_clerk_secret_key

# Database
DATABASE_URL=your_postgresql_url

# Optional: Analytics
NEXT_PUBLIC_ANALYTICS_ID=your_analytics_id

🌟 Features

Form Creation

  • Drag-and-Drop Builder - Intuitive interface for building forms
  • Custom Fields - Text, Multiple Choice, Checkboxes, Date, File Upload
  • Validation Rules - Required fields, email format, number ranges
  • Responsive Design - Forms look great on all devices

Authentication & Security

  • Secure Login - Powered by Clerk Auth
  • Role-Based Access - Admin and User roles
  • Data Encryption - End-to-end encryption for sensitive data
  • GDPR Compliant - Built with privacy in mind

Dashboard

  • Real-time Analytics - Track form submissions
  • Export Options - Download responses as CSV/Excel
  • Search & Filter - Find submissions quickly
  • Visual Reports - Charts and graphs for data analysis

Sharing & Collaboration

  • Unique Links - Share forms via unique URLs
  • Team Management - Collaborate with team members
  • Access Control - Set form visibility and permissions
  • Embed Support - Add forms to any website

πŸ› οΈ Technology Stack

Frontend

  • Next.js - React framework for production
  • Tailwind CSS - Utility-first CSS framework
  • shadcn/ui - Accessible component system
  • Framer Motion - Smooth animations

Backend

  • Prisma - Modern database toolkit
  • PostgreSQL - Reliable database system
  • Clerk Auth - Authentication and user management
  • API Routes - Serverless API endpoints

πŸ“Š System Architecture

graph TD
    A[Client] -->|HTTP/WebSocket| B[Next.js Server]
    B -->|ORM| C[Prisma]
    C -->|SQL| D[PostgreSQL]
    B -->|Auth| E[Clerk]
    B -->|Storage| F[File System]
Loading

πŸš€ Getting Started

Prerequisites

  • Node.js 18+
  • PostgreSQL database
  • Clerk account

Installation Steps

  1. Clone & Install

    git clone https://github.com/vyasvishal/formlab.git
    cd formlab
    npm install
  2. Configure Environment

    • Copy .env.example to .env.local
    • Add your Clerk and PostgreSQL credentials
  3. Database Setup

    npx prisma migrate dev
    npx prisma generate
  4. Start Development

    npm run dev

🀝 Contributing

We love contributions! Here's how you can help:

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit changes (git commit -m 'Add AmazingFeature')
  4. Push to branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ“˜ Documentation

Visit our documentation site for:

  • Detailed API references
  • Integration guides
  • Best practices
  • Video tutorials

🌟 Use Cases

Educational Institutions

  • Student Feedback Forms
  • Event Registration
  • Course Evaluations
  • Research Surveys

Organizations

  • Contact Forms
  • Feedback Collection
  • Application Forms
  • Data Collection

⭐ Why FormLab?

Open Source & Free

  • MIT licensed
  • No hidden costs
  • Self-hostable
  • Community driven

User-Centric Design

  • Intuitive interface
  • Mobile responsive
  • Accessible (WCAG 2.1)
  • Multi-language support

Enterprise Ready

  • Role-based access
  • Audit logs
  • Data encryption
  • API access

πŸ”’ Security

  • End-to-end encryption
  • GDPR compliance
  • Regular security audits
  • Data backups

🌐 About

FormLab is developed by Vyas Vishal under CodeLab, a student club at AMPICS. Our mission is to make form creation and data collection accessible to everyone.

πŸ“« Support

πŸ“„ License

FormLab is open-source software by vyas vishal.


Made with ❀️ by Vyas Vishal and the CodeLab team

About

Open Source Form Builder for the Modern Web

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages