Summary  
The chapter introduces how Angular CLI scaffolds a project’s folder and file structure, explaining the roles of key configuration files (angular.json, tsconfig.json, package.json) and the src/app directory for organizing components, global styles, and application bootstrap logic.

General domain of usage  
Single-page web application development


When you create a project using **Angular CLI**, it generates a well-organized **folder** and **file structure**. This structure plays a crucial role in organizing **code**, making development more **efficient** and **scalable**.

You'll explore the **key folders** and **files** that are automatically created when you set up a new **Angular project**.

# Project Structure

When you run the command `ng new angular-app`, **Angular CLI** generates the following **structure**:

📂 `src/` – **Application Source Code**.

This folder contains the **core files** and **configurations** required for your **Angular application**.

The main folder where components, modules, and services are stored. (We'll explore this in detail later.)

📂 app/

The main HTML file where Angular injects the compiled application.

📄 index.html

The entry point that bootstraps the root module of the application.

📄 main.ts

Global styles applied across the entire application.

📄 styles.css

Defines project settings such as build configurations, styles, and paths.

📄 angular.json

Contains TypeScript settings applied to the entire project.

📄 tsconfig.json

TypeScript configuration specific to the application code.

📄 tsconfig.app.json

TypeScript settings for tests, including compilation rules.

📄 tsconfig.spec.json

Lists project dependencies, package versions, and npm scripts.

📄 package.json

Locks the exact versions of installed packages to ensure consistency.

📄 package-lock.json

Defines code formatting rules like indentation and encoding, supported by most editors.

📄 .editorconfig

These **configuration files** are essential for **project settings**, but you won't need to modify them frequently, especially as a **beginner**.

Note

Specifies files and folders that should be excluded from the Git repository.

📄 .gitignore

Contains project documentation, including installation steps and usage instructions.

📄 README.md

# Running an Angular Application

To launch your **Angular app**, first, open the **terminal**. In **VS Code**, you can use these shortcuts:

- **macOS**: `Cmd + J` or `` Cmd + ` ``;

- **Windows**: `Ctrl + J` or `` Cmd + ` ``.

Alternatively, go to **View** → **Terminal** from the top menu.

Now, run the following **command**:

This **command** compiles the **project** and starts a local **development server**. Once the process is complete, the **terminal** will display a message with a **URL**:

Open the **URL** (`http://localhost:4200/`) in your **browser**, and you'll see the **Angular welcome page**.

The **default welcome page** is a basic **template** generated during **project initialization**. It confirms that your **application** has been successfully set up and is running.

What is the main purpose of the `src` folder in an Angular project?

What is the role of `package.json` in an Angular project?


Discover how to build modern web applications using Angular, one of the most powerful frontend frameworks. You'll start with the core concepts, set up your development environment, and gradually move on to building dynamic, interactive components. Along the way, you'll work with directives, services, routing, and the latest approach with Standalone Components. With each step, you'll gain practical skills to confidently develop and organize Angular applications following industry best practices.

Discover the core concepts of Angular and how it simplifies web development. Learn about its key principles, evolution, and how to set up the necessary tools to start building applications.

Discover the fundamentals of components and templates in Angular, including how they are created, structured, and interact with each other to build dynamic, data-driven applications.

Dive into Angular's directives and pipes to learn how they make your templates smarter and your data cleaner. Discover how to control DOM behavior with directives and transform displayed data with powerful, built-in or custom pipes.

Learn how to organize and reuse logic in your Angular applications using services. You'll discover how to create services and inject them into components with Angular's built-in Dependency Injection system. This keeps your code clean, modular, and easier to maintain.

Learn how Angular applications used to rely on modules and discover why the framework is now embracing a more flexible approach with Standalone Components. Dive into the structure of NgModules, understand their key elements, and explore when and how to use Standalone Components in modern Angular development.

Learn how Angular handles routing and navigation to build dynamic single-page applications. In this section, you'll discover how to define routes and navigate between views using Angular's built-in tools.

Angular Project Structure

Project Structure

Application Code

Configuration Files

Additional Files

Running an Angular Application

1. What is the main purpose of the `src` folder in an Angular project?

2. What is the role of `package.json` in an Angular project?