Siget is designed to go from zero to a running Angular 21 application as fast as possible. This guide walks through every step — from installing prerequisites to seeing your app live in the browser and running your first unit test with Vitest.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/kevinrodriguezmorales/siget/llms.txt
Use this file to discover all available pages before exploring further.
Prerequisites
Before you begin, make sure the following tools are available in your environment:| Tool | Recommended Version | Notes |
|---|---|---|
| Node.js | LTS (20.x or 22.x) | Required to run Angular CLI and npm |
| npm | 10.9.0 | Declared as packageManager in package.json |
| Angular CLI | 21.x | Used for serve, build, and test commands |
Setup
Clone the Repository
Clone the Siget repository from GitHub and navigate into the project directory:
Install Dependencies
Install all project dependencies using npm. Siget declares This installs both runtime dependencies (Angular packages, RxJS) and dev dependencies (Angular CLI, Vitest, Prettier, TypeScript).
"packageManager": "npm@10.9.0", so npm is the recommended package manager:Start the Development Server
Start the local development server using either of these equivalent commands:The Angular CLI will compile the application and start a dev server using the
@angular/build:dev-server builder. By default it targets the development build configuration, which disables optimization and enables source maps for easier debugging.Open the Application
Once the server is running, open your browser and navigate to:
The Angular CLI always serves the application on http://localhost:4200 by default. If that port is already in use, you can specify an alternative with
ng serve --port 4300.Run the Unit Tests
Siget uses Vitest as the test runner, integrated through the Vitest will discover all
@angular/build:unit-test builder. Run the full test suite with:*.spec.ts files in the project — starting with src/app/app.spec.ts — and report results directly in the terminal.Available Scripts
All scripts defined inpackage.json are available via npm:
| Command | Underlying Command | Description |
|---|---|---|
npm start | ng serve | Start the development server with hot reloading |
npm run build | ng build | Compile a production-optimized build into dist/ |
npm run watch | ng build --watch --configuration development | Rebuild automatically on file changes (dev mode) |
npm test | ng test | Run unit tests with Vitest |
Code Scaffolding
The Angular CLI can generate new components, directives, pipes, and more using its built-in schematics. Because Siget configures"style": "scss" in angular.json, all generated components will automatically use SCSS:
Building for Production
To compile an optimized production bundle:dist/ directory. The production configuration enables output hashing for long-term caching and enforces bundle size budgets (500 kB warning, 1 MB error for the initial bundle).
The default build configuration is production. To build with source maps and without optimization, use
ng build --configuration development or run npm run watch for a continuous development build.