Skip to content

md-abu-kayser/professional-typescript-showcase

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Professional TypeScript Showcase - 200 Challenges & Solutions

License: MIT

Demo

Issues

HTML5 CSS3

Tailwind CSS PostCSS daisyUI

Google Fonts Font Awesome Heroicons

JavaScript ECMAScript Spec TypeScript

Node.js

Plain docs links


One repository containing 200 curated TypeScript Problems and 200 fully commented, idiomatic TypeScript Solutions - purpose-built as a portfolio piece, interview prep resource and learning reference.

This README has been extended to be client-facing and recruiter-ready: it explains the project's purpose, how to run and extend it, recommended quality gates, and exactly how solutions are organized so contributors and reviewers can find and run examples instantly.

Table of Contents


Quick highlights

  • 200 problem statements in typescript/200-ts-problems.ts and 200 matching solutions in typescript/200-ts-solved.ts.
  • Lightweight demo page: index.html with js/script.js and css/style.css to preview outputs.
  • Typescript-first approach with tsconfig.json already present.
  • Minimal package.json (dev deps installed) - ready to add scripts for build/test/lint.

Repository layout

Top-level files and their purpose:

  • index.html - demo runner (static page to load a compiled example).
  • typescript/200-ts-problems.ts - problem descriptions, inputs, and notes.
  • typescript/200-ts-solved.ts - solutions, each exported and documented.
  • js/ - compiled/demo JavaScript (used by index.html).
  • css/ - demo page styles.
  • package.json - minimal metadata and devDependencies (add scripts as needed).
  • tsconfig.json - TypeScript compiler configuration used by contributors.
  • LICENSE - MIT license.

Try it locally - Quick start - PowerShell

Open PowerShell in the project root and run:

npm install
npx http-server -c-1 .

If you'd like to run TypeScript sources directly (fast dev iteration):

npm install -D typescript ts-node @types/node
npx ts-node typescript/200-ts-solved.ts

Notes:

  • npx ts-node runs TypeScript files directly in Node.js (good for debugging solutions).
  • The demo in index.html expects compiled JS in js/ or updated imports - compile to js/ if you want browser examples.

How solutions are structured (API and examples)

The typescript/200-ts-solved.ts file exports named functions. Each entry includes:

  • A short problem description (commented).
  • An exported function with a clear name (e.g., reverseWords).
  • JSDoc-style comments for inputs, outputs and complexity. `

Best practices and coding standards used

  • Strict typing and --strict recommended in tsconfig.
  • Small single-responsibility functions; prefer pure functions when possible.
  • Use readonly and immutable patterns for safety where applicable.
  • Document complexity (time/space) and edge cases in comments.

Quality gates, CI and badges (recommended)

Add these checks to GitHub Actions to make the project enterprise-ready:

  • tsc type-check (npx tsc --noEmit)
  • lint (npx eslint) and format checks
  • unit tests (vitest or jest)
  • test coverage and badge (Codecov)

Project Live Demo and Git Repo Clone

  1. Project live link:
https://md-abu-kayser.github.io/professional-typescript-showcase/
  1. Git Repo Clone:
git clone https://github.com/md-abu-kayser/professional-typescript-showcase.git

Contributing (detailed, recruiter and client-friendly)

We want contributions to be high-quality and reviewable. Suggested contribution flow:

  1. Fork the repo and create a branch named feat/<short-description> or fix/<issue-number>.
  2. Implement solution(s) in typescript/200-ts-solved.ts (add new exports) and update typescript/200-ts-problems.ts if adding problems.
  3. Add unit tests for new functions in test/ (I can scaffold a test harness).

FAQ

  1. Question: Are these solutions production-ready?
  • Answer: The solutions are pedagogical and designed for clarity and idiomatic TypeScript. Some solutions prioritize readability and teaching over extreme performance. For production use, add benchmarks and integration tests.
  1. Question: How do I add new problems?
  • Answer: Add the problem description to typescript/200-ts-problems.ts, implement the exported function in typescript/200-ts-solved.ts, and add a unit test in test/.

License

  • This project is licensed under the terms of the MIT License.
  • You may replace or update the license as needed for client or proprietary projects.

Contact & Maintainer

If you’d like this README tailored for a specific purpose - such as hiring managers, open-source contributors, or client deliverables - feel free to request a custom tone or format.


It’s designed to be clean, well-structured, and pleasant to explore - perfect for interviews, typescript portfolio showcases, or professional demos.


Thank you for reviewing this project!


About

200 curated TypeScript challenges with fully-commented, idiomatic solutions - interview prep, portfolio-ready, includes demo, tests, and CI.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors