Skip to main content
Site documentation

How this portfolio is designed, built, and maintained

This page documents the content rules, architecture, project evidence, quality checks, APIs, deployment model, and repository documentation behind danspelt.com.

Portfolio snapshot

2
proof-backed projects
6
deployed applications
0
documented builds in progress
9
API endpoints documented

Standards

Portfolio principles

These rules keep the site credible, accessible, and maintainable as the project portfolio grows.

Evidence before claims

Completed portfolio work is promoted only when it has a public product, a case study, or another verifiable proof point. Marketing language stays subordinate to evidence.

Accessibility by default

Semantic structure, keyboard access, readable contrast, descriptive links, and screen-reader-friendly content are treated as baseline requirements.

Problem-first storytelling

Case studies explain the operational problem, constraints, implementation decisions, outcomes, and tradeoffs rather than only listing technologies.

Maintainable scope

The site favors durable static pages, shared data sources, explicit status labels, and conservative claims that remain accurate as projects evolve.

Content model

What belongs where

The site separates completed proof-backed work from the broader product inventory so visitors see a clear, trustworthy portfolio.

Completed work

The `/work` page is curated. Apps appear there only when they are deployed and have a public case study or equivalent project proof.

Project inventory

`/projects` is the full product inventory. It can show deployed applications and in-development builds without implying that every tool is a finished case study.

Open project inventory

Case studies

Case studies document the problem, approach, decisions, outcomes, evidence, and stack. They are the canonical proof layer for completed portfolio work.

Open case studies

Inventory

Application status register

A concise register of product names, current status, and public destinations. This inventory is broader than the curated completed-work list.

Live

CareBoard

Built for household managers and approved care workers who coordinate daily tasks for a loved one or client. Families benefit from clearer schedules, proof of completion, and a shared record that reduces miscommunication. The result is less stress for caregivers and more accountability for the people they support.

Pilot
Case study available

Community Hive

For property managers, strata councils, and residents who are tired of missed announcements and maintenance requests disappearing into email chains. Communities benefit from one shared place for announcements, requests, documents, and decisions. The impact is fewer repeated questions, faster maintenance resolution, and a clear record of what was communicated.

Live
Case study available

AccessLens

For people with disabilities, caregivers, and accessibility advocates who need to know whether a restaurant, clinic, park, or transit stop will work for them before they travel. Municipalities and businesses benefit from crowdsourced accessibility data that shows where improvements are needed. The impact is safer, more confident trips and better public awareness of accessibility gaps.

Live

Clarity Audit

For website owners, developers, and accessibility teams who need a quick, actionable first look at accessibility barriers. Small businesses and non-profits benefit from prioritized fixes instead of overwhelming scanner reports. The impact is faster remediation and a site that works for more visitors, including people using screen readers or keyboards.

Live

AuditSpark

For business owners, marketers, and web teams who want to turn more visitors into leads or customers. Small businesses benefit from practical fixes to headlines, calls to action, and page structure without hiring a full conversion agency. The impact is clearer messaging, better user flow, and more revenue from the same traffic.

Live

Christian Web Help

For churches, ministries, and faith-led teams that need a website visitors can actually use, including people with disabilities or older members. Congregations and visitors benefit from clear event information, simple donation flows, and accessible content. The impact is stronger community connection and fewer people left out because a site is hard to navigate.

Architecture

Technical foundation

The site is intentionally simple to operate: static-first content, shared data sources, a small API surface, and a repeatable deployment path.

Application framework

  • Next.js App Router with React 19
  • Static-first public pages with server-rendered content where practical
  • Route-level metadata, canonical URLs, Open Graph, and structured data

Interface system

  • Tailwind CSS 4 with shared design tokens
  • Reusable card, badge, and button primitives
  • Responsive layouts designed for mobile first

Content model

  • Canonical project records live in src/data
  • Case-study proof and product status are separate from page markup
  • Shared source data keeps home, projects, work, and assistant content aligned

Operations

  • Docker standalone output for predictable deployment
  • Coolify deployment from the main branch
  • Environment variables isolate secrets and service configuration

Experience

Primary visitor paths

Each audience has a different evidence need. The site structure supports fast scanning first and deeper verification second.

Hiring managers

About → Employment history → Case studies → Contact

Evaluates experience depth, evidence quality, accessibility practice, and role fit.

Business clients

Home → Custom software → Work → Contact

Understands the business problems solved, product approach, and inquiry path.

Technical reviewers

Case studies → Documentation → GitHub → Projects

Inspects architecture, tradeoffs, verification, source material, and shipped scope.

API surface

Documented endpoints

The public site remains mostly static. API routes are limited to integrations, form delivery, diagnostics, and assistant features.

/api/health

Deployment and service health check endpoint.

/api/projects

Project data for site features and integrations.

/api/github

GitHub repository data used by portfolio content.

/api/email

Transactional email through the configured mail provider.

/api/custom-software-inquiry

Custom software inquiry submissions and notification delivery.

/api/business-challenge

Business challenge summaries and optional contact submissions.

/api/ai-chat

Portfolio assistant responses grounded in approved site data.

/api/ai-chat/email

Follow-up delivery for qualified assistant conversations.

/api/github-test

Diagnostic endpoint for validating GitHub integration configuration.

Quality

Verification checklist

Verification is lightweight but explicit. The goal is to catch content, accessibility, build, and integration regressions before deployment.

  • Run npm run lint before considering a change complete.
  • Run npm run build before release-sensitive changes.
  • Use npm run test:health to verify configured service health.
  • Use npm run test:challenge to smoke-test the business challenge flow.
  • Manually verify changed routes for metadata, accessibility, responsive layout, and working links.

Repository

Documentation index

The repository contains the operational source of truth. These documents support setup, deployment, project status, and future maintenance.

Product planning

Developer guide library

Developer guides document product scope, architecture, implementation boundaries, and deployment considerations for planned or sibling applications.

AI Website Audit Tool
AI Quote and Proposal Generator
AI Resume and Cover Letter Fixer
Local Business Content Generator
AI Rental Concierge
Dan Income CRM

Operations

Deployment and maintenance model

The operating model is designed for a solo maintainer: clear source data, deterministic builds, environment-based configuration, and push-to-deploy infrastructure.

Source control

Feature work is reviewed through Git history. Main should remain deployable, and unrelated local changes should not be bundled into focused fixes.

Release path

Changes are verified locally, pushed to main, and deployed by Coolify using the standalone Docker build.

Ongoing review

Project status, dependency alerts, accessibility, metadata, and public claims should be reviewed as the portfolio evolves.

Documentation as part of the product

Clear documentation is treated as an engineering deliverable: it explains what exists, why decisions were made, how to verify the system, and where future work should begin.

Discuss a project