ArCode Persona is an independent avatar creation platform in the ArCode ecosystem. It is designed to let each person build a customizable digital persona while keeping identity data portable and under the user's control.
Current status: interactive prototype and engineering foundation. The current character is procedural placeholder geometry, not a production-quality rigged avatar.
- Full 3D character viewing with orbit, zoom, and responsive preview.
- Customizable face, skin tone, hair, eyes, clothing, and accessories.
- Expressive face and body animation as a production target.
- A broad wardrobe direction that includes Moroccan heritage clothing and contemporary styles.
- Independent core architecture with future versioned SDK/API integrations.
The first design families are djellaba, caftan, takchita, contemporary Moroccan styling, and accessories such as babouches, fez, scarves, belts, jewelry, and eyewear. The catalog is research-first: regional and cultural references must be documented and reviewed. No single outfit is treated as representative of every Moroccan person.
See Moroccan Wardrobe Catalog and the Character JSON Design Schema.
- JavaScript ES modules
- Three.js for 3D rendering
- Vite for development and production builds
- Node.js built-in test runner
- GitHub Actions for CI, preview artifacts, and GitHub Pages deployment
Requirements: Node.js 22 or newer.
npm install
npm run dev
npm test
npm run build
npm run preview| Path | Purpose |
|---|---|
app.js |
Interactive 3D studio and UI behavior |
src/avatar-config.js |
Versioned renderer-independent avatar configuration |
test/ |
Unit tests for the configuration contract |
docs/TECHNICAL_ARCHITECTURE.md |
System boundaries and rendering architecture |
docs/MOROCCAN_WARDROBE_CATALOG.md |
Moroccan clothing research and design direction |
docs/AVATAR_ASSET_PIPELINE.md |
Production 3D asset authoring and validation pipeline |
docs/PRIVACY_AND_SECURITY.md |
Data handling and future server security principles |
docs/QUALITY_GATES.md |
CI and release acceptance criteria |
docs/ROADMAP_EXECUTION.md |
Phased execution plan |
- 360-degree pointer rotation, auto-rotation, and zoom.
- Initial appearance and wardrobe controls.
- Expression and accessory selectors.
- Validated JSON export/import for full character profiles, including body proportions, face shape, nose, jaw, ears, hair details, and clothing construction.
- Local GLB 2.0 avatar import with a 32 MB limit and rejection of external asset URLs.
- Local import of one skinned garment GLB, rebound to the imported avatar by exact skeleton bone names.
- Playback and selection of animation clips embedded in imported GLB avatars.
- Runtime sliders for facial morph targets exposed by imported GLB models (up to 24 controls).
- Live procedural controls for body proportions, facial anatomy, hair details, and clothing fit/embroidery.
- Procedural human anatomy foundation with thorax, abdomen, pelvis, shoulder masses, articulated upper/lower arms, elbows, hands, thighs, knees, calves, ankles, and feet.
- Semantic application of supported design properties to matching GLB morph targets and conventionally named skeleton bones.
- Automatic local browser persistence with no account or server storage.
- Restore saved looks after reloading the studio.
- Responsive Arabic RTL interface.\n- Blender export helper and GLB production-profile validation for skinned avatars and garments.
The built-in preview now includes a more complete stylized human volume, but it remains a procedural anatomy blockout rather than a production-quality human base mesh. It does not yet provide anatomically sculpted muscle groups, realistic hands/fingers, detailed feet, facial topology, or production skin deformation. Users can import a self-contained GLB 2.0 avatar locally (maximum 32 MB); imported assets are not uploaded. Production human topology, finished rigged character assets, authored Moroccan garment meshes, multi-piece outfit composition, realistic cloth simulation, and browser E2E tests are not yet implemented. Procedural geometry is a stylized preview: some detailed proportions are only visually approximate, and imported GLB anatomy changes require compatible morph targets or conventionally named bones; unsupported GLB properties are intentionally left unchanged. The current garment loader is a single-piece rig-binding foundation and requires a compatible garment asset. The new Blender exporter and GLB validator provide production asset tooling, not the missing art assets. See the execution roadmap.
No Darija-LexReview integration is enabled. The current prototype does not require an account or database; look export is local. Future cloud storage requires explicit consent, server-side authorization, and a privacy review.
See CONTRIBUTING.md before opening a pull request.
src/human-proportions.js: shared proportion solver and anatomical landmarks for shoulder, elbow, wrist, pelvis, knee, ankle and foot placement.src/human-rig.js: standardized humanoid bone hierarchy (hips, spine, chest, neck, head, clavicles, arms, hands, fingers, legs, feet and toes) for future animation and skin binding.src/human-anatomy.js: lofted torso surface with smoother ribcage-to-waist-to-pelvis transitions, plus articulated limb blockout.src/color-system.js: Moroccan-inspired palettes and physically based skin/fabric material presets.- The face preview now has more deliberate jaw, cheek, ear and nose sub-shapes; all remain stylized procedural geometry.
The bone hierarchy is currently animation-ready metadata, not yet a weighted SkinnedMesh. The preview anatomy remains a blockout; realistic anatomical topology, fingers, muscle definition and deformation require a dedicated production base mesh and skin weights.