LogoTurboGo
Getting started

Structure

Overview of the default project structure in TurboGo

Project Structure

TurboGo encourages a modular and clean project layout.
This is the default folder structure you get when running turbogo new.


⚠️ The data/ folder only appears if you use Queue or Pubsub with file storage mode.

user.go
router.go
.env
.gitignore
go.mod
go.sum
main.go
README.md

Structure Highlights

  • pkg/controllers/: Contains business logic handlers such as user management, authentication, etc.
  • pkg/routes: Defines routing rules and middleware setup.
  • .env: Holds environment variables like PORT, DB_URL, and secret keys.
  • .gitignore: Specifies which files/folders to exclude from version control (e.g., .env, bin/, node_modules/).
  • go.mod/go.sum : Go module metadata and dependency list.
  • main.go: Application entry point that initializes the server and core services.
  • README.md: Basic documentation about the project, how to run it, and its structure.

Generated with CLI

This layout is generated automatically when you run:

npx create-turbogo my-app