gofasta init

Initializes an existing Gofasta project that was cloned from a repository or copied from another machine. This command creates the .env file, installs Go dependencies, runs Google Wire dependency injection generation, conditionally runs gqlgen GraphQL code generation (if gqlgen.yml exists), runs database migrations, and verifies the project builds successfully.

Use this command instead of gofasta new when you already have the project source code and just need to set up the development environment.

Usage

gofasta init

Run this command from the root directory of your Gofasta project (the directory containing go.mod).

This command takes no flags.

Examples

Initialize a freshly cloned project:

git clone https://github.com/myorg/myapp.git
cd myapp
gofasta init

What It Does

When you run gofasta init, the CLI performs the following steps in order:

1. Create .env file — copies .env.example to .env so you have a working environment configuration
2. Install dependencies — runs go mod tidy to download and synchronize all Go module dependencies
3. Generate Wire code — runs go tool wire ./app/di/ to generate the dependency injection container from your provider definitions
4. Generate GraphQL code (only if gqlgen.yml exists) — runs go tool gqlgen generate to create Go types and resolvers from your .graphqls schema files. This step is automatically skipped for REST-only projects that were created without --graphql.
5. Run migrations — runs migrate -path db/migrations -database <url> up to apply all pending database migrations
6. Verify build — runs go build ./... to confirm the project compiles successfully

When to Use

Related

• gofasta new — create a new project from scratch
• gofasta wire — regenerate only Wire DI code
• gofasta dev — start the development server
• Installation