Skip to content

KitsuneKode/arche

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

223 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Arche — project origin system

CI MIT Bun Release guarded Preset status

Project origin system — personal scaffold CLI and template vault for TypeScript monorepos, Rust services, and Solana foundations.

Site · GitHub · Docs · CLI


Arche is KitsuneKode’s preset-led way to start real projects without re-wiring the boring parts: workspace shape, package-manager catalogs, agent context, deployment notes, and a reproducible arche.json. It began as a full-stack TypeScript template and is now a vault plus @arche/create CLI.

Honest status: foundations are implemented; preset promotion to “stable” waits on the verification matrix. No preset is marketed as production-ready until that matrix passes.

Use the CLI (the fun part)

Published route (after npm release):

npx arche create my-app
# or
bunx arche create my-app

From this repository while developing:

bun run dev:cli -- my-app --yes --dir=../projects

Scaffold outside this template repo when writing real output.

flowchart LR
  dev[Developer] --> cli["arche create"]
  cli --> copy[Template copy]
  copy --> turbo[Rendered turbo.json]
  copy --> ctx[AGENTS.md + arche.json]
  ctx --> app[Your monorepo]
Loading

Terminal block (matches the site)

bun run dev:cli -- my-app --yes --preset=typescript-fullstack --dir=../projects

More examples:

# Interactive
bun run dev:cli -- my-app --dir=../projects

# Rust API
bun run dev:cli -- my-api --yes --preset=rust-api --dir=../projects

# pnpm catalogs
bun run dev:cli -- my-app --yes --preset=typescript-fullstack --pm=pnpm --dir=../projects

# Dry run
bun run dev:cli -- my-app --yes --dry-run --dir=../projects

Presets (pick your fighter)

Preset Status Output today
typescript-fullstack Requires validation Next.js + TypeScript API monorepo
rust-api Requires validation Axum API, module-first layout
rust-fullstack Requires validation Next.js web + services/api Rust API
solana-program Requires validation Planned Anchor programs/core
solana-web Requires validation Planned web dApp + client
solana-mobile Requires validation Planned mobile dApp
solana-product Requires validation Planned web + mobile + program
customize Requires validation Explicit composition
experiments Experimental Opt-in unstable routes

Repository layout

flowchart TB
  subgraph apps [apps]
    cli[cli — @arche/create]
    web[web — docs + design lab]
    server[server — API template]
    worker[worker — optional jobs]
  end
  subgraph packages [packages]
    auth[auth]
    store[store]
    trpc[trpc]
    ui[ui]
  end
  cli --> apps
  cli --> packages
Loading
apps/
  cli/       @arche/create CLI
  web/       documentation / marketing + design lab
  server/    TypeScript API template source
  worker/    optional worker template

packages/
  auth/  backend-common/  store/  trpc/  ui/

toolings/
  catalog/   workspace-catalog.json
  scripts/   repo maintenance + brand:export

Development

bun install
bun run dev:cli -- my-app --yes --dir=/tmp/arche-output
bun test apps/cli/tests
bun run verify:generated
bun run ci
bun run brand:export   # README banner, GitHub icons, OG (needs web build)

Docs grid

Topic Link
Doc index docs/README.md
CLI reference docs/bootstrap-cli.md
Commands docs/commands.md
Deployment hub docs/deployment.md
Env matrix docs/deployment-env.md
Verification matrix .docs/product/verification-matrix.md
Rebranding / GitHub assets docs/rebranding.md

Design lab (not a secret base)

Unlinked previews live at /__design-labnoindex, excluded from the sitemap, not auth-gated. Fine for experiments; don’t treat it as private infrastructure.


Built by KitsuneKode · arche.kitsunelabs.xyz

About

Arche -- preset-led scaffold CLI and full-stack TypeScript monorepo (Next.js, Express, tRPC, Better Auth, Rust, Solana)

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors