4. The full source code and the tools used

Purpose of this post

This post publishes the source code used for the crossword web app. The code is loaded only when you open a file.

Tools used

• Next.js 15, React 19, TypeScript: lobby, game room, APIs
• node:sqlite: storing grids and input records
• gemma4 on Ollama: grid design and clue writing. It is called through an OpenAI-compatible API, so it can be swapped for another model.
• Google News RSS and the Korean Wikipedia API: current-affairs headlines and random words
• OpenSubtitles Korean frequency ranking: word grades

Folder layout

• lib/puzzle.ts: difficulty settings, turning a grid into a clue list, criteria checks
• lib/gridFill.ts: grid validation and correction, pre-drawn grids, word filling, the word-joining placer
• lib/dynamicBank.ts: AI grid design, AI clue writing, news and wiki words
• lib/words.ts, freqRanks.ts: word bank and frequency ranks
• lib/db.ts: game record DB, partial saves, cleaning up empty grids
• app/page.tsx, app/play/page.tsx: lobby and game room
• app/api: new grid, record saving, listing and resuming APIs
• components/CrosswordBoard.tsx: drawing the grid
• scripts/text-agent.ts, ai-pipeline-test.ts: tools that test the generator and the AI process as text

To run it, copy .env.local.example to .env.local and fill in the model address. Without a model, grids are built from the word bank and wiki words alone. The game record DB, ad and deployment scripts, and the server monitor are not included.

Full source