GoAuth

Community

Contribute to GoAuth and get help

Get Help

Contributing

Contributions are welcome. Here's how:

  1. Fork the repository
  2. Create a branch (git checkout -b feature/my-feature)
  3. Make your changes
  4. Run make build and make test to verify
  5. Commit and push
  6. Open a pull request

Code Patterns

Follow the existing patterns:

  • Exported interface / unexported struct for services
  • types.GoAuthError for service/HTTP errors; ordinary error for lifecycle and storage contracts
  • Dot-notation route names (e.g., core.signup)
  • Embedded OpenAPI specs per module
  • config.Component (Name and Init) plus optional capabilities; the existing eight-method config.Module interface remains supported

Adding a Module

Use the scaffolding scripts:

cd internal/modules
./new_module_with_route.sh mymodule      # Module with routes
./new_module_with_no_route.sh mymodule   # Middleware-only module

Documentation

Help improve documentation by:

  • Fixing errors or unclear explanations
  • Adding examples
  • Keeping code samples up to date

Resources

Edit this page on GitHub

On this page