What dot new writes

Every file dot new creates, before you run anything. Nothing runs in your browser: this is the command's own dry-run plan.

next from @arki/dot 0.7.0 · release candidate, commit 0e70527, 21 Oct 2026

stack default38 files, 56.0 KB
minimal 8 files, 5.6 KB

Get this plan yourself, as JSON

dot new arki-app --dry-run --json

Template: stack default

App folder arki-app/ · 38 files, 56.0 KB · all new, all yours to edit

Run

dot new arki-app

Planned files

Path	Size	What it is
.dockerignore	80 B	Keeps node_modules, build output and env files out of the Docker context
.env.example	322 B	Env vars the app reads, with local defaults
.gitignore	157 B	Ignores for node_modules, build output, env files
AGENTS.md	3.1 KB	Agent guide: where features live, how to add one, dot explain / dot doctor
Dockerfile	1.2 KB	Multi-stage Bun image that builds and serves the Nitro output
README.md	3.4 KB	Run locally, deploy to Coolify, what comes next
docker-compose.yml	578 B	Postgres for local development
drizzle.config.ts	520 B	drizzle-kit config: schema files and migrations folder
drizzle/20261014000000_init/migration.sql	2.1 KB
drizzle/20261014000000_init/snapshot.json	15.3 KB
package.json	1.4 KB	Package manifest: TanStack Start, oRPC, @arki/dot, @arki/db, @arki/journal, @arki/ui
public/favicon.svg	165 B
src/app.ts	2.4 KB	The DOT app: log, env, db, migrations, journal
src/entry-server.ts	362 B
src/env.ts	444 B	Env schema (zod) consumed by @arki/env/dot
src/features/notes/note.ts	1.2 KB
src/features/notes/notes.test.ts	1.9 KB
src/features/notes/procedures.ts	862 B
src/features/notes/repository.ts	699 B
src/features/notes/tables.ts	816 B
src/lib/orpc.ts	705 B
src/routeTree.gen.ts	3.0 KB
src/router.tsx	1.1 KB
src/routes/__root.tsx	1.4 KB
src/routes/api/health.ts	826 B
src/routes/api/rpc.$.ts	1.0 KB
src/routes/index.tsx	3.7 KB
src/server/db.ts	641 B
src/server/journal-tables.ts	549 B
src/server/journal.ts	976 B
src/server/orpc.ts	794 B
src/server/router.ts	228 B
src/server/runtime.ts	1.1 KB
src/styles.css	494 B
src/testing.ts	815 B
tsconfig.json	669 B	Strict TypeScript config for the whole app
vite.config.ts	948 B	Vite + TanStack Start + Nitro + Tailwind
vitest.config.ts	368 B	Vitest config (tests use in-memory PGlite, no Docker)

Next steps

5 commands, in order

cd arki-app
bun install
cp .env.example .env
docker compose up -d
bun run dev

Template: minimal

App folder arki-app/ · 8 files, 5.6 KB · all new, all yours to edit

Run

dot new arki-app --template minimal

Planned files

Path	Size	What it is
.gitignore	48 B	Standard ignores for node_modules, dist, env files
AGENTS.md	2.5 KB	Agent-readable conventions (verification commands, public/private boundaries, DOT artifact locations)
README.md	447 B	Quickstart and inspection commands
package.json	421 B	Package manifest with @arki/dot + @arki/env dependencies
src/app.ts	676 B	App entrypoint composing defineApp + env adapter
src/env.ts	275 B	Env schema (zod) consumed by @arki/env/dot
tests/boot.test.ts	772 B	Vitest that boots the app and asserts manifest shape
tsconfig.json	574 B	TypeScript config for ESM + NodeNext + strict mode

Next steps

3 commands, in order

cd arki-app
bun install
bun run test