codexgo

README

Example CRUD project applying Hexagonal Architecture, Domain-Driven Design (DDD), Command Query Responsibility Segregation (CQRS), Behavior-Driven Development (BDD), Continuous Integration (CI), and more... in Go

Features

• Devcontainer

  • Features
  • Extensions & Settings

• Docker

  • Dockerfile
    • Multistage
  • Compose
    • Setup by ENV

• GitHub

  • Actions & Workflows
    • Setup Languages and Dependencies
    • Secrets Scanning, Linting & Test Checks
    • Upgrade Dependencies
    • Automate Release
  • Issue Templates (Defaults)

• Git

  • Hooks
    • Pre-Commit
      • Secrets Scanning & Formatting
    • Commit-Msg
      • Check Conventional Commits rules

• Releases

  • Automatically
    • Hooks
      • Linting & Test Checks
    • Bump Version (based on Conventional Commits & SemVer)
    • CHANGELOG
    • Commit & Tag
    • GitHub Release

First Steps

Clone

HTTPS

git clone https://github.com/bastean/codexgo.git && cd codexgo

SSH

git clone git@github.com:bastean/codexgo.git && cd codexgo

Initialize

Dev Container (recommended)

1. Install required

   • Docker

     • Dev Containers

2. Start VS Code

   code .
   

3. Open Command Palette

   • Ctrl+Shift+P

4. Run

   Dev Containers: Reopen in Container
   

Locally

1. Install required

   • Go
   • Node
   • Make
   • Docker

2. Run

   make init
   

ZIP

1. Install required

2. Run

   make from-zero
   

Repository

Settings

• Actions

  • General

    • Workflow permissions

      • Read and write permissions

• Secrets and variables

  • Actions

    • New repository secret

      • BOT_GPG_PRIVATE_KEY

        gpg --armor --export-secret-key [Pub_Key_ID (*-BOT)]
        

      • BOT_GPG_PASSPHRASE

Run

Development

make compose-dev

Test

make compose-test

Production

make compose-prod

Screenshots

Tech Stack

Base

• Go
• templ
  • htmx
  • Alpine.js
  • Tailwind CSS
    • daisyUI

Please see

• go.mod (from Workspaces)
• package.json

Contributing

• Contributions and Feedback are always welcome!

License

• MIT