Contributing

Thanks for your interest in contributing to HeySummon!

Development Setup

git clone https://github.com/thomasansems/hitlaas-platform.git
cd hitlaas-platform
cp .env.example .env.local   # configure your environment
npm install
npx prisma generate
npx prisma db push
npm run dev

Running Tests

npm run test          # unit tests (vitest)
npm run test:watch    # watch mode
npm run test:e2e      # end-to-end tests (Playwright)

Pull Request Guidelines

Branch from main
Use descriptive commit messages
Keep PRs focused — one feature or fix per PR
Ensure npm run test and npm run build pass before submitting
Update documentation if applicable

Code Style

TypeScript throughout
ESLint for linting (npm run lint)
Use @/ path aliases for imports
Prefer functional components and server components where possible

Project Structure

hitlaas-platform/
├── src/
│   ├── app/           # Next.js App Router pages
│   ├── components/    # React components
│   ├── lib/           # Core utilities (crypto, auth, etc.)
│   └── middleware.ts   # Rate limiting, CORS, auth
├── prisma/            # Database schema and migrations
├── skills/            # OpenClaw skills
├── infra/             # Terraform Azure deployment
├── relay/             # Standalone Express relay server
└── scripts/           # Setup and utility scripts

Security Vulnerabilities

Do not open a public issue for security vulnerabilities.

Report via email: security@thomasansems.nl

Include a description, steps to reproduce, and potential impact.

Compliance API Reference