Skip to content

Technical writing

Writing

Notes, technical guides, and lessons from building backend systems, web applications, and developer-focused products.

On this site

Writing on amitkmishra.dev

Practical articles about workflow architecture, maintainable Spring Boot systems, and diagnosing production failures.

Workflow architecture6 min read

Designing Reliable Booking and Duty State Transitions

A practical field guide to explicit workflow state, permissions, downstream billing effects, auditability, and frontend–backend consistency.

  • Workflow design
  • State machines
  • Fleet operations
Read article
Spring Boot architecture6 min read

Building Maintainable Spring Boot Platforms Without Premature Microservices

A practical architecture guide to modular monoliths, service boundaries, DTOs, internal events, transactions, and the point where distribution becomes justified.

  • Spring Boot
  • Modular architecture
  • Platform engineering
Read article
Production diagnostics6 min read

From Business Error to Production Diagnosis

A practical guide to safe frontend errors, protected backend diagnostics, correlation IDs, structured logging, exception handling, and useful observability.

  • Error handling
  • Observability
  • Spring Boot
Read article

External publications

Published on BuildBaseKit

I also publish practical backend engineering articles through BuildBaseKit, covering Spring Boot, authentication, file storage, system architecture, performance, and AI-assisted development.

Blogs

1
BlogAI-assisted development

AI Backend Development Without Rebuilding Everything

How a stable backend foundation helps AI-assisted development focus on product behavior instead of repeatedly generating setup code.

BuildBaseKit

Guides

19
GuideAI-assisted development

How to Make a Spring Boot Project AI-Ready

A practical guide to giving coding agents clear architecture, project context, documentation, and safer operating rules.

BuildBaseKit
GuideDiscord bots

Java Discord Bot Scheduler and Background Jobs

Patterns for scheduled tasks and background jobs in Java Discord bots built with JDA.

BuildBaseKit
GuideFile storage

S3 Pre-Signed URLs in Spring Boot

How to generate short-lived S3 URLs for protected file access and scalable downloads from Spring Boot.

BuildBaseKit
GuideFile storage

When to Use AWS S3 for Spring Boot File Storage

A decision guide for choosing object storage or keeping a simpler local-storage architecture.

BuildBaseKit
GuideDiscord bots

Java Discord Bot Architecture for Scalable JDA Bots

A modular approach to slash commands, event handling, services, and maintainable JDA bot structure.

BuildBaseKit
GuideAuthentication and files

Spring Boot JWT File Upload Security Guide

How authentication, authorization, validation, and controlled file handling fit together in a secured upload API.

BuildBaseKit
GuideAuthentication

Spring Boot Authentication Architecture

A clean separation of controllers, services, security filters, token handling, and persistence for JWT authentication.

BuildBaseKit
GuideFile storage

Spring Boot Large File Upload

Configuration limits, streaming considerations, validation, and service boundaries for handling large uploads.

BuildBaseKit
GuideFile storage

How to Store and Serve Files in Spring Boot

A local-storage design that keeps file metadata, path rules, download behavior, and application boundaries explicit.

BuildBaseKit
GuideFile storage

Production-Ready Spring Boot File Upload Architecture

An end-to-end upload design covering validation, metadata, secure storage, access control, delivery, and object storage.

BuildBaseKit
GuideFile storage

Upload Files to AWS S3 with Spring Boot

A Spring Boot S3 upload architecture using storage abstraction, validation, and pre-signed access patterns.

BuildBaseKit
GuideDiscord bots

Discord Bot Structure in Java

A maintainable Java and JDA project structure with separate commands, events, and application services.

BuildBaseKit
GuideFile storage

File Upload Mistakes in Spring Boot

Common production failure modes in upload APIs, from weak validation and unsafe filenames to unclear storage boundaries.

BuildBaseKit
GuideDiscord bots

JDA Discord Bot Mistakes to Avoid

Common JDA design mistakes and the structural changes that keep Java Discord bots easier to extend.

BuildBaseKit
GuideAuthentication

JWT Mistakes in Spring Boot

Security and maintainability problems that frequently appear in Spring Boot JWT implementations.

BuildBaseKit
GuideFile storage

Spring Boot File Upload API with MultipartFile

A controller-and-service implementation using MultipartFile, validation, safe filenames, and structured storage.

BuildBaseKit
GuideAuthentication

Security in Spring Boot with JWT and Spring Security

A guide to JWT authentication, password hashing, role-based authorization, and protected Spring Boot APIs.

BuildBaseKit
GuideDiscord bots

How to Build and Deploy a Java Discord Bot Using Spring Boot

A complete JDA bot path from Spring Boot structure and event handling to a reliable VPS deployment.

BuildBaseKit
GuideDeployment

How to Deploy a Production-Ready File Server on a VPS for Free

A deployment guide for running a Spring Boot file server with Nginx, TLS, and systemd on a VPS.

BuildBaseKit

Comparisons

5
ComparisonDiscord bots

Java Discord Bot Template vs Building From Scratch

A comparison of starting with a structured JDA template and assembling a Java Discord bot from an empty project.

BuildBaseKit
ComparisonFile storage

Best Firebase Storage Alternative for Scalable Backends

A comparison of managed file storage and a Spring Boot API backed by controlled local or S3 storage.

BuildBaseKit
ComparisonFile storage

Local Storage vs S3 for Spring Boot File Uploads

Trade-offs between local disks and Amazon S3 for upload architecture, delivery, operations, and scale.

BuildBaseKit
ComparisonAuthentication

Spring Boot Authentication Boilerplate vs Building From Scratch

A comparison of reusable authentication foundations and a custom implementation, including control, maintenance, and delivery trade-offs.

BuildBaseKit
ComparisonAuthentication

JWT vs Session Authentication in Spring Boot

A practical comparison of token and session authentication, including revocation, scaling, browser security, and operational complexity.

BuildBaseKit

Benchmarks

1
BenchmarkPerformance

Spring Boot File Upload Performance Test: Real Load Test Results at 7,500 RPM

A load-test report covering file-upload latency, throughput, resource use, and the bottlenecks observed under a 7,500 RPM workload.

BuildBaseKit