Skip to content

About

Generate corporate governance documents (board resolutions, written consents, meeting minutes, officer letters, stock option grants, compliance certifications) from simple form inputs. Outputs clean Word (.docx) files with a document repository and governance calendar.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

Board & Corporate Governance Document Generator

Generate common corporate governance documents from simple form inputs. Output clean, consistent Word (.docx) files ready for review and execution.

Getting Started

Option 1: Hosted Version (Easiest)

Coming soon — a hosted version will be available at a public URL.

Option 2: Run Locally

./start.sh        # macOS/Linux
start.bat          # Windows

This installs everything automatically, starts the app, and opens your browser. No Python experience needed.

Option 3: Docker

docker compose up

Then open http://localhost:8501 in your browser.

Deploy Your Own

Railway (One-Click Cloud Deploy)

  1. Fork this repo
  2. Connect your GitHub to Railway
  3. Create a new project from your fork
  4. Railway auto-detects the Dockerfile and deploys

Features

Document Generation (6 Types)

  • Board Resolutions — company name, date, resolution text, approving directors, vote count
  • Written Consents — company name, action, consenting directors/shareholders
  • Meeting Minutes — company name, date, attendees, agenda items, resolutions, action items
  • Officer Appointment/Resignation Letters — officer name, title, effective date, company
  • Stock Option Grants — grantee, shares, exercise price, vesting schedule, grant date
  • Annual Compliance Certifications — entity, jurisdiction, certification period, certifying officer

Document Repository

  • Browse, search, and filter all generated documents
  • Track document status: Draft, Approved, Executed
  • Download any document at any time

Governance Calendar

  • Track board meeting schedules and annual governance deadlines
  • Upcoming events summary and overdue alerts
  • Create, edit, and complete calendar events

For Developers

API Documentation

With the API running, visit http://localhost:8000/docs for interactive Swagger documentation.

Project Structure

gdg_app/                    # FastAPI backend
  main.py                   # App entry point
  config.py                 # Settings
  models.py                 # SQLAlchemy models
  schemas.py                # Pydantic schemas
  database.py               # Database setup
  routers/                  # API endpoints
  services/                 # Business logic & document generation
  templates/                # .docx templates (auto-generated)
gdg_frontend/               # Streamlit frontend
  app.py                    # Main entry point
  pages/                    # Multi-page app
data/
  sample/                   # Synthetic example data
  generated/                # Generated documents (gitignored)
tests/                      # pytest test suite

Running Tests

pip install -e ".[dev]"
pytest

Tech Stack

  • Backend: Python 3.11+, FastAPI, SQLAlchemy 2.0, Pydantic v2
  • Document Generation: docxtpl, python-docx
  • Database: SQLite (prototype), designed for PostgreSQL migration
  • Frontend: Streamlit
  • Deployment: Docker, Railway

License

MIT License - Copyright (c) 2026 Noam Raz and Pleasant Secret Labs

About

Generate corporate governance documents (board resolutions, written consents, meeting minutes, officer letters, stock option grants, compliance certifications) from simple form inputs. Outputs clean Word (.docx) files with a document repository and governance calendar.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages