This repository contains the code for internet chowkidar, a web application that allows users to monitor any blocks, bans, or restrictions on the internet by their ISP. The application is built using Go and PostgreSQL.

• Logging: Structured logging with slog
• Configuration: Configuration management with koanf
• HTTP Server: HTTP server with net/http
• Database: DB ORM with ent
• Task Runner: Task runner with just

• Go >= 1.21.5
• redocly (generate API documentation)
• oas3-api-snippet-enricher (add curl examples to API Docs)
• ent (DB ORM)
• goose (DB migrations tool)
• ogen (generate APIs)
• wire (dependency injection)
• just (task runner)

1. Clone the repository
2. Install the dependencies

go mod tidy

4. Set up local environment variables using the .env.example file.

cp .env.example .env

5. Run codegen

just # yes, that's it, nothing else

6. Run the application

just run

• spec (openapi config file for API Routes)
• internal/config (server config files)
• api/handler (how to handle each route)
• migrations (add/edit new tables)

Necessary for generating APIs, DB schemas, dependency injection, etc. A detailed explanation of the codegen process can be found here.

This repository contains a devcontainer configuration for Visual Studio Code. The devcontainer is pre-configured with all the necessary tools and extensions to start developing right away. A detailed explanation of the devcontainer can be found here.

Refer to the migrations documentation for more information on how to create and apply migrations.