Nature
nature LanguageLibraryFrameworkToolDatabaseEngineBridgeInfrastructurePlatformProtocolSaaSStandard
Reference & Ontology
The definitive guide to PokeDev's Data and API.
Card Anatomy (Data Model)
ConceptIn PokeDev, every Technology is a Card. We
enforce a Strict Schema policy: no unknown
fields are allowed. Every card must include its Identity Metadata (designer, first_release, package_name) to be valid.
1. Identity (Art & Soul)
Slug, Name, and visual Assets. Defines who the card is.
2. Data (Stats & Types)
Rigid technical specs. Validated against the Deck Building Rules.
e.g. Runtime Type (Water/Fire), Consistency Model (Attack Power)Why the split?
Data is the immutable core (like a card's printed HP).
Tags are the current meta (like an attached Energy card).
Deck Building Rules (System Ontology)
Architect ReferenceJust like a TCG has a "Standard Format", our System Validator serves as the Head Judge. It enforces strict rules on the Data layer. Any field not defined in the schema will be rejected (extra="forbid").
Nature
nature Runtime Type
runtime_types Concurrency
concurrency_models Memory
memory_management Protocols
protocols Consistency
consistency_model Resource Intensity
resource_intensity Stable Release
stable_release Licenses (SPDX)
licenses Website
website Repository
repository Identity (Designer)
designer First Release
first_release Package Name
package_name Native Binary
native_packages Interfaces
interfaces Paradigm
tags:paradigm:* Typing
tags:typing:* Domain
tags:domain:* Layer
tags:layer:* Features
tags:feature:* ø Banned Mechanics (Forbidden Keys)
These keys are Banned from the Data layer. If you need them, use Tags instead:
Game Actions (API Commands)
EndpointsCards
The core entity of the PokeDev universe. Everything revolves around cards.
GET /api/v1/cards
List all cards with filtering (search, category, licenses, popularity).
GET /api/v1/cards/{slug}
Retrieve detailed information for a specific card.
Stacks
Manage private and shared technology stacks.
POST /api/v1/stacks/private
Create a new private stack.
GET /api/v1/stacks/share/{id}
Retrieve a shared stack by its unique ID.
Oracle
AI-powered recommendation engine for technology choices.
POST /api/v1/oracle/consult
Get stack recommendations based on a Q&A payload.
POST /api/v1/oracle/validate
Check compatibility between two specific cards.
Contribution
Community-driven database updates.
POST /api/v1/suggestions
Submit a new suggestion for review.