# Hackhaton-Space-Stack

> A modern CLI for scaffolding end-to-end type-safe TypeScript projects with best practices and customizable configurations.

## When to use Hackhaton-Space-Stack

Use Hackhaton-Space-Stack when a developer or coding agent needs to scaffold a new TypeScript application, reproduce a selected stack from a command, add supported features to an existing Hackhaton-Space-Stack project, inspect compatibility rules, or generate a project through a structured interface.

Hackhaton-Space-Stack does not expose a public hosted application API. The supported automation interfaces are the CLI, its JSON commands, the programmatic npm API, and the local stdio MCP server.

## Quick start

```bash
npx create-hackhaton-space-stack@latest my-app
```

Non-interactive default project:

```bash
npx create-hackhaton-space-stack@latest my-app --yes
```

## Agent interfaces

- JSON project creation: `create-hackhaton-space-stack create-json --input '{...}'`
- JSON project updates: `create-hackhaton-space-stack add-json --input '{...}'`
- JSON schemas: `create-hackhaton-space-stack schema --name all`
- Local MCP server: `npx create-hackhaton-space-stack@latest mcp`
- [Agent workflow guide](https://hackhaton-space.vercel.app/docs/cli/agent-workflows.mdx)
- [Programmatic API](https://hackhaton-space.vercel.app/docs/cli/programmatic-api.mdx)

## Documentation

- [Quick Start](https://hackhaton-space.vercel.app/docs/index.mdx) — Create your first Hackhaton-Space-Stack project in minutes
- [Commands](https://hackhaton-space.vercel.app/docs/cli.mdx) — Complete reference for all CLI commands
- [Agent Workflows](https://hackhaton-space.vercel.app/docs/cli/agent-workflows.mdx) — JSON-first and schema-driven workflows for agents, scripts, and automation
- [Compatibility Rules](https://hackhaton-space.vercel.app/docs/cli/compatibility.mdx) — Understanding compatibility rules and restrictions between different CLI options
- [Options Reference](https://hackhaton-space.vercel.app/docs/cli/options.mdx) — Complete reference for all CLI options and flags
- [Programmatic API](https://hackhaton-space.vercel.app/docs/cli/programmatic-api.mdx) — Use Hackhaton-Space-Stack programmatically in your Node.js applications
- [Using the interactive prompts](https://hackhaton-space.vercel.app/docs/cli/prompts.mdx) — How to navigate and answer the CLI's interactive questions
- [Frequently Asked Questions](https://hackhaton-space.vercel.app/docs/faq.mdx) — Short answers to common beginner questions
- [Guides](https://hackhaton-space.vercel.app/docs/guides.mdx) — Practical guides for common setups
- [Deploying with Alchemy](https://hackhaton-space.vercel.app/docs/guides/cloudflare-alchemy.mdx) — Deploy Hackhaton-Space-Stack projects to Cloudflare or Prisma and manage hosted databases in the same typed stack
- [Deploying with Docker Compose](https://hackhaton-space.vercel.app/docs/guides/docker.mdx) — Learn how to self-host your Hackhaton-Space-Stack app with the generated Dockerfiles and docker-compose.yml
- [Deploying to Vercel](https://hackhaton-space.vercel.app/docs/guides/vercel.mdx) — Learn how to deploy your Hackhaton-Space-Stack app to Vercel using Vercel Services
- [HSS Config (hss.jsonc)](https://hackhaton-space.vercel.app/docs/hss-config.mdx) — What the HSS hss.jsonc file does and why it matters
- [Project Structure](https://hackhaton-space.vercel.app/docs/project-structure.mdx) — Understanding the structure of projects created by the HSS CLI

## Academy

- [Agent](https://hackhaton-space.vercel.app/academy/agent.mdx) — An AI that takes actions, not just answers.
- [Agents SDK](https://hackhaton-space.vercel.app/academy/agents-sdk.mdx) — A starter kit for building your own AI worker.
- [API](https://hackhaton-space.vercel.app/academy/api.mdx) — How your app — and your AI — talk to other software.
- [Async](https://hackhaton-space.vercel.app/academy/async.mdx) — Work that runs without making everything else wait in line.
- [Auth](https://hackhaton-space.vercel.app/academy/auth.mdx) — How your app knows who someone is.
- [Branch](https://hackhaton-space.vercel.app/academy/branch.mdx) — A safe copy of the project to try changes on.
- [Bug](https://hackhaton-space.vercel.app/academy/bug.mdx) — When the software does the wrong thing and everyone calls it a bug.
- [Build](https://hackhaton-space.vercel.app/academy/build.mdx) — Turning source into the thing you actually run or ship.
- [Cache](https://hackhaton-space.vercel.app/academy/cache.mdx) — A nearby copy so you don't walk to the walk-in every time.
- [CDN](https://hackhaton-space.vercel.app/academy/cdn.mdx) — Copies of your static files kept close to each visitor.
- [CI/CD](https://hackhaton-space.vercel.app/academy/ci-cd.mdx) — A robot that tests, builds, and ships every time you push.
- [CLAUDE.md](https://hackhaton-space.vercel.app/academy/claude-md.mdx) — The house rules your AI reads before it starts.
- [CLI](https://hackhaton-space.vercel.app/academy/cli.mdx) — Type the order. Skip the dining room.
- [The Cloud](https://hackhaton-space.vercel.app/academy/cloud.mdx) — Someone else's computers, rented by the hour and reached over the internet.
- [Commit](https://hackhaton-space.vercel.app/academy/commit.mdx) — A labeled snapshot you can return to.
- [Compaction](https://hackhaton-space.vercel.app/academy/compaction.mdx) — Summarizing the chat so it keeps fitting.
- [Computer Use](https://hackhaton-space.vercel.app/academy/computer-use.mdx) — AI that clicks and types like a person at the desk.
- [Context Window](https://hackhaton-space.vercel.app/academy/context-window.mdx) — How much your AI can hold in mind at once.
- [Cookie](https://hackhaton-space.vercel.app/academy/cookie.mdx) — A small note the browser keeps and sends back to that site.
- [CORS](https://hackhaton-space.vercel.app/academy/cors.mdx) — The browser asking the other site if your page is allowed to call it.
- [Cron](https://hackhaton-space.vercel.app/academy/cron.mdx) — An alarm clock that runs a job on a schedule.
- [Daemon](https://hackhaton-space.vercel.app/academy/daemon.mdx) — A process that stays on in the background. Not a demon.
- [Database](https://hackhaton-space.vercel.app/academy/database.mdx) — The cabinet software talks to, so tomorrow isn't empty.
- [Dependency](https://hackhaton-space.vercel.app/academy/dependency.mdx) — Someone else's code you install so you don't rebuild the wheel.
- [Deploy](https://hackhaton-space.vercel.app/academy/deploy.mdx) — Open the doors so other people can use it.
- [DNS](https://hackhaton-space.vercel.app/academy/dns.mdx) — The internet's phone book for names.
- [Docker](https://hackhaton-space.vercel.app/academy/docker.mdx) — A sealed box that runs the same way on every machine.
- [DRY](https://hackhaton-space.vercel.app/academy/dry.mdx) — Write it once. Reuse it everywhere.
- [Edge](https://hackhaton-space.vercel.app/academy/edge.mdx) — Running code near the user instead of in one faraway basement.
- [Embedding](https://hackhaton-space.vercel.app/academy/embedding.mdx) — Meaning turned into a list of numbers a computer can compare.
- [Encryption](https://hackhaton-space.vercel.app/academy/encryption.mdx) — Scrambling data so the machines in the middle only see noise.
- [Endpoint](https://hackhaton-space.vercel.app/academy/endpoint.mdx) — One specific address on an API.
- [Env File](https://hackhaton-space.vercel.app/academy/env.mdx) — Where secret keys live, out of the code.
- [Eval](https://hackhaton-space.vercel.app/academy/eval.mdx) — A test that tells you if the change helped or quietly hurt.
- [Feature Flag](https://hackhaton-space.vercel.app/academy/feature-flag.mdx) — A switch in the live app that hides a feature without a new deploy.
- [Fine-tuning](https://hackhaton-space.vercel.app/academy/fine-tuning.mdx) — Sending the model back to school on your examples.
- [Fork](https://hackhaton-space.vercel.app/academy/fork.mdx) — Your own full copy of someone else's project.
- [Frontend & Backend](https://hackhaton-space.vercel.app/academy/frontend-backend.mdx) — What people touch, and what has to stay true.
- [Git](https://hackhaton-space.vercel.app/academy/git.mdx) — Save points for your code.
- [GitHub](https://hackhaton-space.vercel.app/academy/github.mdx) — Where the code lives and gets shared.
- [Guardrails](https://hackhaton-space.vercel.app/academy/guardrails.mdx) — Limits you put on an AI before it does something dumb.
- [Hallucination](https://hackhaton-space.vercel.app/academy/hallucination.mdx) — When AI sounds confident and is just wrong.
- [Harness](https://hackhaton-space.vercel.app/academy/harness.mdx) — The car built around the AI engine.
- [Headless](https://hackhaton-space.vercel.app/academy/headless.mdx) — Software that runs with no screen, nobody watching.
- [HTTP Methods](https://hackhaton-space.vercel.app/academy/http-methods.mdx) — Get, create, update, delete — the verbs of the web.
- [Inference](https://hackhaton-space.vercel.app/academy/inference.mdx) — The moment the model actually answers.
- [Job](https://hackhaton-space.vercel.app/academy/job.mdx) — One specific piece of work sitting in a queue.
- [JSON](https://hackhaton-space.vercel.app/academy/json.mdx) — The little note card almost every API writes on.
- [KISS](https://hackhaton-space.vercel.app/academy/kiss.mdx) — Keep it simple. Skip the clever version.
- [Latency](https://hackhaton-space.vercel.app/academy/latency.mdx) — The beat between the click and the thing happening.
- [Localhost](https://hackhaton-space.vercel.app/academy/localhost.mdx) — A private website that runs only on your machine.
- [Log](https://hackhaton-space.vercel.app/academy/log.mdx) — A receipt printer that never stops.
- [Markdown](https://hackhaton-space.vercel.app/academy/markdown.mdx) — Plain text that formats itself.
- [MCP](https://hackhaton-space.vercel.app/academy/mcp.mdx) — A universal plug for your AI's tools.
- [Merge](https://hackhaton-space.vercel.app/academy/merge.mdx) — Folding one branch back into another — and the fight when both changed the same line.
- [Monorepo](https://hackhaton-space.vercel.app/academy/monorepo.mdx) — One house, many rooms.
- [Multimodal](https://hackhaton-space.vercel.app/academy/multimodal.mdx) — A model that can take more than text — images, audio, video.
- [OAuth](https://hackhaton-space.vercel.app/academy/oauth.mdx) — A valet key for an account — not the master key.
- [Object Storage](https://hackhaton-space.vercel.app/academy/object-storage.mdx) — A giant bucket on the internet for files.
- [Open Source](https://hackhaton-space.vercel.app/academy/open-source.mdx) — Code anyone can read, use, and improve.
- [ORM](https://hackhaton-space.vercel.app/academy/orm.mdx) — A translator between your code and the database.
- [Patch](https://hackhaton-space.vercel.app/academy/patch.mdx) — The small change that fixes the bug.
- [Permission Scope](https://hackhaton-space.vercel.app/academy/permission-scope.mdx) — Exactly which doors a key is allowed to open.
- [Process](https://hackhaton-space.vercel.app/academy/process.mdx) — One running instance of a program — a living copy, not the file.
- [Progressive Disclosure](https://hackhaton-space.vercel.app/academy/progressive-disclosure.mdx) — Show the short version. Keep the depth one step away.
- [Prompt Caching](https://hackhaton-space.vercel.app/academy/prompt-caching.mdx) — Pay once to read it, reuse it cheaply.
- [Prompt Injection](https://hackhaton-space.vercel.app/academy/prompt-injection.mdx) — Hostile instructions hiding in the text you asked the AI to read.
- [Pull Request](https://hackhaton-space.vercel.app/academy/pull-request.mdx) — A proposed change, put up for review.
- [Queue](https://hackhaton-space.vercel.app/academy/queue.mdx) — A line of work so fast things don't trample each other.
- [RAG](https://hackhaton-space.vercel.app/academy/rag.mdx) — The open-book exam: look it up, then answer.
- [Rate Limit](https://hackhaton-space.vercel.app/academy/rate-limit.mdx) — A bouncer that says you asked too many times.
- [Reasoning](https://hackhaton-space.vercel.app/academy/reasoning.mdx) — Letting the model work a problem before it blurts.
- [Refactoring](https://hackhaton-space.vercel.app/academy/refactoring.mdx) — Tidying the code without changing what it does.
- [REST](https://hackhaton-space.vercel.app/academy/rest.mdx) — The common rulebook most HTTP APIs follow.
- [Rollback](https://hackhaton-space.vercel.app/academy/rollback.mdx) — Putting the last good version back on stage.
- [Runtime](https://hackhaton-space.vercel.app/academy/runtime.mdx) — The engine that actually runs your code.
- [Sandbox](https://hackhaton-space.vercel.app/academy/sandbox.mdx) — A playpen so the agent can be wrong without wrecking the house.
- [Schema](https://hackhaton-space.vercel.app/academy/schema.mdx) — The promised shape of the data — labeled boxes, each a type.
- [SDK](https://hackhaton-space.vercel.app/academy/sdk.mdx) — A toolkit for building on someone else's service.
- [Secret](https://hackhaton-space.vercel.app/academy/secret.mdx) — A string that must stay hidden or someone else can act as you.
- [Server](https://hackhaton-space.vercel.app/academy/server.mdx) — A computer that never closes.
- [Serverless](https://hackhaton-space.vercel.app/academy/serverless.mdx) — Rent a computer for a moment, not a month.
- [Session](https://hackhaton-space.vercel.app/academy/session.mdx) — One continuous conversation with your AI.
- [Skill](https://hackhaton-space.vercel.app/academy/skill.mdx) — A saved recipe your AI can follow on demand.
- [Slash Command](https://hackhaton-space.vercel.app/academy/slash-command.mdx) — A keyboard shortcut for a whole prompt.
- [SSH](https://hackhaton-space.vercel.app/academy/ssh.mdx) — A secure terminal on a computer you are not sitting at.
- [Stack](https://hackhaton-space.vercel.app/academy/stack.mdx) — The combo of tools your app is built from.
- [Stack Trace](https://hackhaton-space.vercel.app/academy/stack-trace.mdx) — The list of calls the program was in when it crashed.
- [Staging](https://hackhaton-space.vercel.app/academy/staging.mdx) — A dress rehearsal of production, with fake or extra-careful data.
- [State](https://hackhaton-space.vercel.app/academy/state.mdx) — The stuff the app has to remember while it's running — and after.
- [System Prompt](https://hackhaton-space.vercel.app/academy/system-prompt.mdx) — The standing instructions your AI always follows.
- [Technical Debt](https://hackhaton-space.vercel.app/academy/technical-debt.mdx) — Shortcuts now that you pay interest on later.
- [Temperature](https://hackhaton-space.vercel.app/academy/temperature.mdx) — The dial between a careful clerk and a jazz solo.
- [Test](https://hackhaton-space.vercel.app/academy/test.mdx) — A script that checks the code still does the thing after you touch it.
- [Token](https://hackhaton-space.vercel.app/academy/token.mdx) — The unit AI reads and writes in.
- [Tool Calling](https://hackhaton-space.vercel.app/academy/tool-calling.mdx) — The line between a chatbot and an agent is tools.
- [Trace](https://hackhaton-space.vercel.app/academy/trace.mdx) — A map of where the time went when the app felt slow.
- [Type Error](https://hackhaton-space.vercel.app/academy/type-error.mdx) — The compiler refusing a shape it did not agree to.
- [Vector Database](https://hackhaton-space.vercel.app/academy/vector-database.mdx) — Storage that finds things by meaning, not exact words.
- [Vibe Coding](https://hackhaton-space.vercel.app/academy/vibe-coding.mdx) — Building by describing it and letting AI write the code.
- [Voice Agents](https://hackhaton-space.vercel.app/academy/voice-agents.mdx) — An agent you talk to out loud.
- [Webhook](https://hackhaton-space.vercel.app/academy/webhook.mdx) — An app that pings you the moment something happens.
- [Worker](https://hackhaton-space.vercel.app/academy/worker.mdx) — A small program that runs one job on demand.
- [YAGNI](https://hackhaton-space.vercel.app/academy/yagni.mdx) — Don't build what you don't need yet.
- [YAML](https://hackhaton-space.vercel.app/academy/yaml.mdx) — JSON's cousin that humans can stand to edit.

## Project resources

- [Complete documentation in one Markdown file](https://hackhaton-space.vercel.app/llms-full.txt)
- [Academy](https://hackhaton-space.vercel.app/academy)
- [Browser stack builder](https://hackhaton-space.vercel.app/builder)
- [npm package](https://www.npmjs.com/package/create-hackhaton-space-stack)
- [GitHub repository](https://github.com/dzulhelmynazri/create-hackhaton-space-stack)
- [Sitemap](https://hackhaton-space.vercel.app/sitemap.xml)