This example project is a comprehensive farm-themed demo for django-forms-workflows.

Instead of starting from a blank admin, it can seed a realistic showcase with:

• multi-step forms
• public/anonymous intake
• notifications and webhook configuration
• dynamic assignees, send-back, reassign, and editable approvals
• sequential + parallel workflow stages
• sub-workflows
• prefill sources and post-submission actions
• API-enabled forms and API token auth
• batch import and spreadsheet fields
• analytics-friendly demo submissions

1. Install dependencies

   pip install -e ..

2. Run migrations

   python manage.py migrate

3. Seed the full demo

   python manage.py seed_farm_demo

4. Run the development server

   python manage.py runserver

5. Open the demo

   • Home: http://localhost:8000/
   • Forms: http://localhost:8000/forms/
   • Approval inbox: http://localhost:8000/forms/approvals/
   • Analytics: http://localhost:8000/forms/analytics/
   • API docs: http://localhost:8000/api/docs/
   • Admin: http://localhost:8000/admin/

All demo accounts use password farm123.

• farmer_brown — superuser / admin
• farmer_jane — normal submitter
• mechanic_mike — equipment operator approver
• finance_faith — finance approver
• safety_sam — safety approver
• owner_olive — executive/final approver
• irrigation_ivan — irrigation specialist
• integration_ivy — integration/API token user

The seed command also creates a Farm Demo API Token and prints it in the command output.

Shows:

• dynamic assignee by email
• send-back to prior stage
• reassign + editable approval data
• approval-step fields
• multifile uploads
• notification rules
• webhook endpoint configuration

Shows:

• multi-step layout
• conditional fields
• calculated fields
• API-enabled form access
• parallel approvals
• conditional executive approval stage
• bulk export / bulk PDF export
• approval-step fields
• notification rules + webhook endpoint

Shows:

• sequential approval logic
• detached sub-workflows
• child Irrigation Zone Checklist workflow generation

Shows:

• public/anonymous form submission
• signature field
• conditional logic
• multifile evidence upload
• PDF generation anytime

Shows:

• prefill sources
• database post-submission action
• API post-submission action configuration

Shows:

• batch import
• Excel template generation

Shows:

• spreadsheet file field

1. Visit the home page and open a few showcase forms.
2. Sign in as farmer_jane and submit forms.
3. Sign in as finance_faith, mechanic_mike, or owner_olive to process approvals.
4. Explore /forms/analytics/ to see seeded historical submissions.
5. Inspect Admin for:
   • Form Builder
   • Workflow Builder
   • Notification Rules
   • Webhook Endpoints
   • Webhook Delivery Logs
   • Post-Submission Actions
   • API Tokens

• Quickstart
• Workflows
• Notifications
• Workflow Webhooks
• Post-Submission Actions
• Visual Workflow Builder