OpenFunnels

OpenFunnels is an open-source funnel builder and CRM-lite app for launching lead-capture funnels quickly. It combines a visual drag-and-drop editor, premade starter templates, custom domain mapping, lead capture forms, contact records, and operational lead notifications.

The current MVP focuses on the first useful growth loop: build a funnel, publish or preview it, capture leads, notify the owner, and review each contact's submissions, notes, metadata, and status.

Screenshots

Homepage

Editor

Features

• Visual funnel editor: Drag-and-drop section, column, and block editing with undo/redo support.
• Starter templates: Build from scratch or choose from 15 premade layouts with categories and visual thumbnails.
• Responsive preview: Desktop, tablet, and mobile preview modes for editor layouts.
• Publishing: Public funnel rendering, preview routes, publish/unpublish controls, and slug-based sharing.
• Custom domains: Application-layer custom domain mapping with DNS verification for published funnels.
• Lead capture: Public form submissions create or update contacts and increment funnel conversions.
• CRM-lite contacts: Contact index and detail pages with source funnel, submissions, metadata, notes, and lifecycle status.
• Lead notifications: Email notification on new leads, plus optional webhook delivery.
• Export modules: Exporter structure for HTML, Laravel, React, Vue, WordPress, Shopify, and WooCommerce targets.

Tech Stack

Backend

• Laravel 12
• PHP 8.2+
• Inertia.js 2
• Eloquent ORM
• SQLite for local development
• Pest for tests

Frontend

• React 19
• TypeScript
• Vite
• Tailwind CSS 4
• Radix UI and local shadcn-style primitives
• lucide-react icons
• Zustand + Immer editor state

Prerequisites

• PHP 8.2 or higher
• Composer
• Node.js 18 or higher
• pnpm

Installation

1. Clone the repository:

   git clone https://github.com/aialvi/openfunnels.git
   cd openfunnels

2. Install dependencies:

   composer install
   pnpm install

3. Configure the app:

   cp .env.example .env
   php artisan key:generate

4. Create and migrate the local database:

   touch database/database.sqlite
   php artisan migrate
   php artisan db:seed

5. Optional environment settings:

   # Custom domain DNS checks
   DOMAIN_MAPPING_CNAME_TARGET=cname.openfunnels.com
   DOMAIN_MAPPING_A_RECORD_IP=
   
   # Lead capture operations
   LEAD_CAPTURE_NOTIFICATION_EMAIL=
   LEAD_CAPTURE_WEBHOOK_URL=

Development

Start the full local stack:

composer run dev

That command starts Laravel, the queue listener, log tailing, and Vite. The app is available at http://localhost:8000.

You can also run Laravel and Vite separately:

php artisan serve
pnpm run dev

Build frontend assets:

pnpm run build

Testing And Quality

# PHP tests
composer test
# or
php artisan test

# PHP formatting
./vendor/bin/pint

# Frontend formatting and checks
pnpm run format
pnpm run format:check
pnpm run lint
pnpm run types

Note: pnpm run lint runs ESLint with --fix, so it may edit files.

Project Structure

app/
├── Http/Controllers/
│   ├── ContactController.php        # Contacts, detail, status, and notes
│   ├── FunnelController.php         # Funnel CRUD, preview, publish, public rendering
│   └── LeadCaptureController.php    # Public funnel form submissions
├── Mail/
│   └── NewLeadCaptured.php          # New lead email notification
├── Models/
│   ├── Contact.php
│   ├── ContactSubmission.php
│   └── Funnel.php
└── Policies/

resources/
├── js/
│   ├── components/                  # Reusable UI and editor components
│   ├── pages/                       # Inertia pages
│   ├── stores/funnelStore.ts        # Editor state, history, actions
│   └── types/editor.ts              # Canonical editor types
└── css/app.css                      # Tailwind 4 and theme tokens

database/
├── migrations/
└── seeders/

docs/
├── ai-instructions/
└── prds/

Documentation

• AGENTS.md: contributor and AI-agent working guide.
• DESIGN.md: product UI and design direction.
• Roadmap.md: current foundation, near-term priorities, and longer feature tracks.
• docs/prds/mvp-funnel-crm.md: MVP funnel builder and CRM-lite requirements.
• docs/prds/domain-mapping.md: custom domain mapping requirements.
• docs/ai-instructions/domain-mapping-agent-rules.md: implementation rules for domain mapping.

Current Roadmap

Completed foundation:

• Laravel + Inertia application shell with authentication and settings.
• Funnel CRUD, dashboard stats, editor, preview, publish, and public rendering.
• Starter template flow with categorized premade layouts and visual thumbnails.
• Custom domain mapping at the Laravel/React application layer.
• Lead capture forms, contacts, contact details, submissions, notes, statuses, email notifications, and optional webhooks.

Near-term priorities:

• Improve form field configuration in the editor.
• Add contact search, filters, CSV import/export, and duplicate management.
• Add UI-managed lead notification settings.
• Improve autosave/manual save flows.
• Move starter template definitions into a scalable template library module.
• Add UTM/source attribution, analytics trends, and funnel drop-off reporting.

Longer-term tracks include automation workflows, SMS and email campaigns, calendar booking, agency sub-accounts, payments, A/B testing, and deeper analytics.

Contributing

1. Fork the repository.
2. Create a feature branch.
3. Make focused changes.
4. Run the relevant tests and checks.
5. Update documentation when behavior, commands, or architecture changes.
6. Open a pull request.

Development guidelines:

• Follow Laravel conventions and PSR-12 style for PHP.
• Use TypeScript for frontend code.
• Reuse existing UI primitives and editor types before adding new abstractions.
• Add tests for behavior touching routing, authorization, validation, persistence, or public rendering.
• Keep generated build output out of commits unless production assets are explicitly requested.

Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions

License

This project is open source and available under the MIT License.