Anima Codex

An open-source desktop character sheet for Anima: Beyond Fantasy. Built with Tauri + SvelteKit + TypeScript.

Prerequisites

Before running the project, ensure you have the following installed:

On Windows, also ensure you have:

• Microsoft C++ Build Tools — select "Desktop development with C++"
• WebView2 Runtime — pre-installed on Windows 11

Getting Started

1. Clone the repository

git clone https://github.com/CFernan/anima-codex.git
cd anima-codex

2. Install dependencies

npm install

3. Run in development mode

npm run tauri dev

The first build will take several minutes as Cargo downloads and compiles Rust dependencies. Subsequent builds will be significantly faster.

Building for Production

To produce a release executable for your current platform:

npm run tauri build

The output artifacts will be located in src-tauri/target/release/bundle/:

Note: Linux and macOS builds will be added when the CI/CD pipeline is configured (US-32).

Project Structure

anima-codex/
├── docs/                   # Project documentation
│   ├── requirements.md
│   ├── architecture.md
│   ├── tasking.md
│   └── pseudo_schema_acx.md  # Normative .acx file format reference
├── examples/               # .acx example files
├── src/                    # Frontend (SvelteKit + TypeScript)
│   ├── lib/
│   │   ├── engine/         # Rules engine — no UI dependencies
│   │   ├── schema/         # Zod schemas and inferred types
│   │   │   ├── common/     # Primitives shared by acx & catalog
│   │   │   ├── acx/        # Character file (.acx) schemas
│   │   │   └── catalog/    # Catalog validation contracts (base & custom)
│   │   ├── catalogs/       # Default official content (satisfies catalog schemas)
│   │   ├── stores/         # Svelte reactive stores
│   │   └── i18n/           # Localisation files
│   ├── components/         # (pending — US-16 onwards)
│   │   ├── sheet/          # Character sheet sections
│   │   ├── shared/         # Reusable UI primitives
│   │   └── layout/         # App layout components
│   ├── routes/             # SvelteKit file-based routing
│   └── app.html            # HTML root template
├── src-tauri/              # Desktop wrapper (Rust)
│   ├── src/
│   │   ├── main.rs
│   │   └── lib.rs
│   ├── capabilities/       # Tauri permission declarations
│   ├── icons/              # Application icons
│   └── tauri.conf.json
├── tests/                  # Unit tests (Vitest)
│   └── lib/
│       ├── schema/         # Schema validation tests
│       └── catalogs/       # Default catalog integrity tests
├── tools/                  # (pending — backlog) Standalone utilities
│   └── xlsx-migrator/
└── static/                 # Static assets

Documentation

• Requirements
• Architecture
• .acx File Format

License

This project is open-source. License TBD.