@exanderal/stackcraft 0.0.1 → 0.1.0

package/CLAUDE.md

@@ -1,95 +0,0 @@
-# Stackcraft — Claude Context
-
-## What is this project
-
-Stackcraft is an opinionated full-stack project scaffolding CLI tool, open source on GitHub under the `@exanderal` npm scope. The goal is to let developers (including beginners and AI agents) spin up production-ready monorepo projects with minimal configuration.
-
-**npm package name:** `stackcraft` (unscoped, claimed by exanderal)
-**npm scope:** `@exanderal`
-**npm username:** `exanderal`
-
-## Architecture Decisions
-
-- **Monorepo tool:** Nx (chosen over Turborepo for first-class Expo/React Native support via `@nx/expo`)
-- **Package manager:** pnpm
-- **Prompt library:** `@clack/prompts` (not inquirer)
-- **Process runner:** `execa`
-- **Language:** TypeScript throughout
-
-## Repo Structure
-
-```
-/
-├── packages/
-│   ├── cli/                        # Binary: npx stackcraft
-│   ├── config-eslint/              # @exanderal/config-eslint (versioned)
-│   ├── config-typescript/          # @exanderal/config-typescript (versioned)
-│   └── config-prettier/            # @exanderal/config-prettier (versioned)
-├── templates/
-│   ├── base/                       # Nx workspace root scaffolding
-│   ├── api-nestjs-rest/            # NestJS REST structure
-│   ├── api-nestjs-graphql/         # NestJS GraphQL structure (Phase 2)
-│   ├── web-vite/                   # Vite + React
-│   ├── web-nextjs/                 # Next.js
-│   └── mobile-expo/                # Expo (Phase 2)
-├── addons/                         # Post-creation installers (Phase 3+)
-├── nx.json
-└── pnpm-workspace.yaml
-```
-
-## CLI Design
-
-Two layers:
-
-1. **Create** — `npx stackcraft` interactive wizard for beginners, presets for power users
-2. **Add** — `stackcraft add [addon]` post-creation addon system for power users and AI agents
-
-### Create Flow (wizard)
-- Project name
-- Backend: NestJS REST / NestJS GraphQL
-- Frontend: Vite + React / Next.js
-- Mobile: None / Expo
-- Package manager: pnpm (default) / npm
-
-### Add System (addon interface)
-```ts
-interface Addon {
-  name: string
-  description: string
-  requires: AppType[]
-  incompatible?: AddonName[]
-  install: (ctx: AddonContext) => Promise<void>
-}
-```
-
-## Phase Roadmap
-
-| Phase | Scope |
-|---|---|
-| 1 (current) | Nx workspace + CLI skeleton + NestJS REST + Vite + Next.js templates |
-| 2 | NestJS GraphQL template + codegen pipeline + Expo |
-| 3 | `stackcraft add` system + first addons (auth, supabase, firebase) |
-| 4 | Presets, --config JSON input, dry-run mode for AI agents |
-
-## Key Conventions
-
-- `apps/` — runnable applications (api, web, mobile, landing)
-- `packages/` — shared code (graphql types, ui components, configs)
-- Every app has the same scripts: `dev`, `build`, `test`, `lint`
-- Shared configs live in versioned `@exanderal/config-*` packages so users can update via `pnpm update`
-- Generated GraphQL types live in `packages/graphql/generated` — single source of truth
-
-## Addons Strategy
-
-Handpicked only due to maintenance overhead. Planned categories:
-- Auth (e.g. better-auth)
-- State management
-- DB services (Supabase, Firebase)
-- NestJS repository patterns
-
-## What NOT to do
-
-- Do not add features beyond what is asked
-- Do not over-engineer templates — they should be minimal and clear
-- Do not add addons that can't be properly maintained
-- Keep the beginner wizard flow simple — descriptions on every option

package/index.js

@@ -1 +0,0 @@
-console.log("stackcraft coming soon");