Skip to content

About

Personal website for Austin Horstman.

Resources

Stars

2 stars

Watchers

1 watching

Forks

Repository files navigation

Austin Horstman Dotnet Angular App

Badge for GitHub repo top language Badge for GitHub last commit

Docker WebApp - Develop Docker WebApi - Develop Angular WebApp Build .NET WebApi Build

Description

The what, why, and how:

Personal portfolio website showcasing professional experience, projects, and skills. Built with Angular 22.x and powered by Bun for optimal performance. The application features a modern navigation system, interactive project showcases, and comprehensive professional information. Contains all projects related to my time as a software engineer and detailed resume information for anyone interested in learning more.

Table of Contents

Installation

Steps required to install project and how to get the development environment running:

Prerequisites

  • Bun: Install Bun runtime and package manager
  • .NET SDK (demo only): Use the exact SDK pinned in WebApi/global.json for the optional WebApi demo
  • Node.js 22+ (demo tests only): Runs the built-in HTTP integration tests
  • Docker (optional): For containerized deployment

Frontend Setup (Angular WebApp)

cd WebApp
bun install                # Install dependencies
bun run start:dev          # Start development server

Optional demo setup (.NET WebApi)

If this is your first time with dotnet development locally, you must trust the local https development certificates:

dotnet dev-certs https --trust

Usage

Instructions and examples for use:

Frontend Development

cd WebApp
bun run start:dev          # Development server with hot reload
bun run build:dev          # Development build
bun run watch              # Watch mode development

Optional demo development

cd WebApi
dotnet watch run           # Development server with hot reload

Production Build

cd WebApp
bun run build:prod         # Production build
bun run docker:build       # Docker production build

Docker Deployment

Production Compose uses the hardened image and binds WebApp to 127.0.0.1:8080:

docker compose up --build --detach

The default stack runs only the frontend. WebApi is a template demo, not a portfolio dependency. Opt in explicitly:

docker compose --profile demo up --build --detach

The demo API is available only on the internal Docker network. Compose publishes no WebApi host port.

Use the explicit development configuration when you need the development servers:

docker compose -f docker-compose.development.yml up --build

Read the homelab deployment controls before configuring the Unraid template or reverse proxy.

Contributing

If you would like to contribute it, you can follow these guidelines for how to do so.

  • Create feature branches and submit a PR into main.

Tests

Tests for application and how to run them:

Frontend Tests (Bun)

cd WebApp
bun run test               # Run all tests
bun run test:coverage      # Run tests with coverage report
bun run test:watch         # Run tests in watch mode
bun run test:ci            # Run tests for CI environment

Optional demo endpoint tests

Use the pinned .NET SDK and Node.js 22+. Run inside WebApi so global.json selects the SDK:

cd WebApi
dotnet restore --locked-mode
dotnet build --configuration Release --no-restore
node --test tests/endpoints.test.mjs

These execute three HTTP integration tests against the Release DLL in Production: weather forecast data and two Swagger routes that must return 404. There is no .NET test project; dotnet test does not exercise these endpoints.

Quality Assurance

cd WebApp
bun run check              # Run full quality check (lint + format + test)
bun run lint               # Lint code
bun run format             # Format code with Biome and Prettier
bun run typecheck          # TypeScript compilation check

License

GNU AGPLv3


Questions?

khaneliman

For any questions, please contact me with the information below:

GitHub: @khaneliman

About

Personal website for Austin Horstman.

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages