---
type: project
status: active
source: git.alwisp.com
repo: jason/codedump
repo_url: https://git.alwisp.com/jason/codedump
language: TypeScript
branch: main
tags: [repo, jason]
updated: 2026-05-29
---

# codedump

**Repository:** [jason/codedump](https://git.alwisp.com/jason/codedump) · branch `main` · TypeScript

## Summary

Internal dashboard for tracking AI tools and coding projects — shows completion status, links documentation, and manages team access via admin accounts and PINs

## Current status

Active. Synced from Gitea on 2026-05-29.

## Documentation overview

_Source: PROJECT.md_

# CODEDUMP

Internal dashboard for tracking AI tools and coding projects. Provides a high-level overview of what the team is building, what tools are available, and the completion status of active work — all in one place.

---

## Purpose

CODEDUMP gives teams a single place to:

- Track AI tools and coding projects with completion percentages
- Attach markdown documentation and project files
- Link to internal/external URLs and Google Drive sources
- Highlight new tools available to the team
- Manage access via admin accounts and 4-digit user PINs

---

## Tech Stack

| Layer | Technology |
|---|---|
| Frontend | React 18 + TypeScript + Vite |
| Styling | Tailwind CSS (dark mode, CSS variable theming) |
| Backend | Node.js + Express + TypeScript |
| Database | SQLite via `better-sqlite3` |
| Auth | JWT (12h expiry) + bcryptjs (admin passwords) + HMAC-SHA256 (user PINs) |
| File uploads | Multer (local disk storage) |
| Markdown | `react-markdown` + `remark-gfm` |
| Container | Docker (multi-stage build, single container) |

---

## Project Structure

```
codedump/
├── client/                          # React frontend
│   ├── src/
│   │   ├── api/index.ts             # Typed fetch wrappers (JWT injected automatically)
│   │   ├── hooks/
│   │   │   ├── useAuth.ts           # AuthContext — JWT storage, login/logout
│   │   │   └── useSettings.ts       # SettingsContext — branding, accent color
│   │   ├── components/
│   │   │   ├── layout/
│   │   │   │   ├── Layout.tsx       # App shell (sidebar + outlet)
│   │   │   │   └── Sidebar.tsx      # Nav — auth-aware, admin section, logout
│   │   │   ├── projects/
│   │   │   │   ├── ProjectCard.tsx  # Card with progress bar, links, tags
│   │   │   │   └── ProjectForm.tsx  # Create/edit form with color picker

…(truncated — see repo)

## Notes

- Project file auto-created from repo documentation.