MORE RE-ORGANIZING

docs/art-direction.md

@@ -0,0 +1,845 @@
+# Sanctification TCG - Art Direction
+
+## Goal
+
+I want the cards and the product as a whole to have a very distinct visual identity.
+
+The current direction I like most is:
+
+> **Stained-glass-inspired as the main style, with tapestry and illuminated manuscript influence as supporting texture and ornament.**
+
+The overall goal should be:
+
+> **Sacred, beautiful, and stylized. Not a dense museum reconstruction.**
+
+I do not want the cards to feel like a generic fantasy TCG, casino game, anime card game, or hyper-realistic historical reenactment.
+
+The art should feel reverent and Christian first, while still being visually strong enough that collecting the cards feels exciting.
+
+---
+
+## Core Visual Principles
+
+Across the whole product, the artwork should generally follow these ideas:
+
+- Sacred and reverent tone.
+- Stained-glass-inspired composition.
+- Jewel-tone palette where appropriate.
+- Gold can be used as an accent, but should become more prominent as rarity increases.
+- Tapestry, linen, parchment, and illuminated-manuscript textures can support the overall look.
+- Clear subject silhouettes.
+- Cards should remain readable at thumbnail size.
+- Avoid hyper-photorealism.
+- Avoid anime or comic-book energy.
+- Avoid a dark fantasy aesthetic.
+- Avoid visual language that feels like gambling, loot boxes, or a casino.
+- Avoid overly dense historical reconstruction.
+- Prefer symbolic clarity over excessive detail.
+- Every card should feel like it belongs to the same product, even when different sets or traditions have their own visual flavor.
+
+A good way to think about the stained-glass direction is that the cards should feel inspired by sacred windows and devotional art without needing to literally reproduce any specific historical style.
+
+---
+
+## Product-Wide Visual Language
+
+The card art should influence the rest of the app.
+
+Possible shared UI motifs:
+
+- Cathedral-window or arched shapes.
+- Restrained ornamental dividers.
+- Deep blue, burgundy, cream, green, and gold accents.
+- Parchment, stone, linen, or subtle glass-inspired surfaces.
+- Illuminated-manuscript-style decorative elements used sparingly.
+- Soft lighting rather than neon effects.
+- Ornament should support hierarchy rather than fill every empty space.
+
+The application UI should still feel modern and usable.
+
+The goal is not to make the entire interface look medieval.
+
+The historical / sacred art direction should mostly come through:
+
+- Cards.
+- Pack openings.
+- Binder / collection presentation.
+- Headers and section treatments.
+- Decorative accents.
+- Important moments and milestones.
+
+Normal application controls should remain clear and familiar.
+
+---
+
+# Card Art
+
+## General Composition
+
+Cards should generally prioritize:
+
+1. Subject.
+2. Identity.
+3. Short supporting content.
+4. Ornamentation.
+
+The art should be readable even when the card is relatively small.
+
+The card should not require the user to zoom in just to understand who or what it represents.
+
+For character cards, prefer:
+
+- One clear subject.
+- Strong silhouette.
+- Limited background complexity.
+- Symbolic items associated with the subject.
+- Calm, iconic poses over excessive action scenes unless the card itself represents an event.
+
+For event cards, larger compositions and multiple figures can be used when necessary.
+
+For locations, items, doctrines, councils, and other categories, the framing can change while still staying within the same overall stained-glass visual language.
+
+---
+
+## Text on the Card
+
+The physical card should stay concise.
+
+The app itself can provide the deeper educational content when the card is inspected.
+
+A normal card can contain:
+
+- Name.
+- Short subtitle or descriptor.
+- Short verse, quote, or historical line.
+- Reference.
+
+Example:
+
+> **David**  
+> Shepherd King  
+>  
+> “The LORD is my shepherd...”  
+> Psalm 23:1
+
+The front content priority should generally be:
+
+1. Scripture directly related to the card.
+2. Historically significant Christian quotation.
+3. Concise historical or theological statement.
+
+We should not force a full verse onto the card when it harms the visual design.
+
+A short excerpt with an ellipsis is fine when it is clearly intentional.
+
+The full content can appear in the inspection panel.
+
+---
+
+## Card Back
+
+The card back should generally be standardized so it does not reveal the identity of a card during pack opening.
+
+The back should not leak:
+
+- Card identity.
+- Exact rarity.
+- Printing.
+- Finish.
+- Material.
+- Other traits that would spoil the reveal.
+
+It can use the Sanctification branding and common visual language.
+
+Different sets could potentially have different backs in the future, but only if this does not meaningfully spoil the card reveal.
+
+---
+
+# Card Inspection
+
+The card itself should remain relatively clean.
+
+More detailed information belongs in the inspection experience.
+
+When inspecting a card, the user should be able to:
+
+- Rotate the card freely.
+- Flip between front and back.
+- Zoom in to inspect artwork and physical characteristics.
+- Observe material properties responding dynamically to lighting.
+- Observe wear and imperfections where applicable.
+- Return quickly to the originating collection / binder context.
+
+The inspection UI should also expose the educational and collectible information that does not need to live directly on the physical card.
+
+Possible sections:
+
+## About
+
+- Full verse or quote.
+- Description.
+- Historical context.
+- Theological context.
+- Related Scripture.
+- Related events / people / cards.
+- Learn-more sources.
+
+## Card
+
+- Rarity.
+- Set.
+- Printing.
+- Finish.
+- Material.
+- Wear classification.
+- Exact wear percentage.
+
+## Provenance
+
+- Original owner.
+- Date opened.
+- Population.
+- Serial / instance information.
+
+---
+
+## Card Dimensions and Resolution
+
+### Aspect Ratio
+
+All standard cards should use a **5:7 portrait aspect ratio**.
+
+This corresponds cleanly with the current physical prototype dimensions:
+
+- Width: 63 mm
+- Height: 88.2 mm
+
+Artwork, card frames, masks, material maps, and generated assets should
+all use the same 5:7 coordinate space unless a specific experiment
+requires otherwise.
+
+### Master Artwork Resolution
+
+The standard master artwork resolution should be:
+
+**3000 × 4200 px**
+
+This is the source-quality asset and should be retained even if smaller
+versions are generated for the application.
+
+All associated masks should use the same dimensions and alignment where
+practical, including:
+
+- Foil masks
+- Holographic masks
+- Metallic masks
+- Roughness maps
+- Wear masks
+- Normal/bump maps
+- Printing masks
+
+### Runtime Resolutions
+
+Runtime assets may be generated from the master depending on context:
+
+- High-resolution inspection: 2000 × 2800
+- Standard card rendering: 1000 × 1400
+- Binder / collection thumbnails: 500 × 700 or smaller
+
+Exact runtime sizes should eventually be determined through performance
+testing, particularly on mobile devices.
+
+The master artwork should never be replaced by a lower-resolution
+runtime export.
+
+---
+
+# Rarity Art Direction
+
+Rarity should have a major impact on the visual grammar of the card.
+
+A common card should not look almost as impressive as a legendary card.
+
+Rarity should primarily affect:
+
+- Frame complexity.
+- Number of ornamental elements.
+- Visual storytelling.
+- Palette richness.
+- Composition complexity.
+- Symbolic detail.
+- Amount of gold.
+- Background complexity.
+
+Rarity should **not** simply mean adding more glow or visual effects.
+
+A useful principle:
+
+> **Higher rarity should add storytelling and ornamentation, not merely more effects.**
+
+Another way to think about it:
+
+> **Common cards should feel like a simple parish stained-glass window. Legendary cards should feel closer to the centerpiece window behind the altar.**
+
+---
+
+## Common
+
+Common cards should be intentionally restrained.
+
+### Border
+
+- Thin and simple.
+- Geometric.
+- Very little decorative ornament.
+- No elaborate corner medallions.
+- No complex illuminated-manuscript scrollwork.
+- No gold.
+
+### Color
+
+- Limited palette.
+- Roughly 2-3 dominant colors plus cream / parchment.
+- More muted or restrained jewel tones.
+- Gold used mostly for separation or small accents.
+
+### Artwork
+
+- It doesn't need to be just the subject but rather them in the background doing something
+- Simple background.
+- Larger stained-glass panes.
+- Fewer small glass segments.
+- Minimal symbolic elements.
+- Calm composition.
+- No unnecessary visual drama.
+- Minimal micro-detail.
+
+### Overall Feel
+
+- Humble.
+- Clean.
+- Grounded.
+- Accessible.
+- Still beautiful, but obviously not premium.
+
+Example:
+
+**Timothy**
+
+- Timothy holding a scroll.
+- Simple ancient street or landscape.
+- Simple arch.
+- Blue / green / cream palette.
+- Thin brass or gold divider.
+- No ornate botanical frame.
+- No special corner symbols.
+- No heavily gilded title plaque.
+
+![alt text](image-2.png)
+
+---
+
+## Uncommon
+
+Uncommon cards can begin introducing more refinement.
+
+### Border
+
+- Slightly thicker frame.
+- Small decorative accents.
+- Limited corner ornament.
+- Some leaf or manuscript-inspired motifs.
+
+### Color
+
+- Slightly broader palette.
+- More saturated jewel tones.
+- Small use of gold.
+
+### Artwork
+
+- More detailed backgrounds.
+- Additional symbolic element.
+- Slightly more complex stained-glass segmentation.
+- More deliberate framing around the subject.
+
+### Overall Feel
+
+- Refined.
+- Noticeably more interesting than Common.
+- Still not highly ornate.
+
+---
+
+
+## Rare
+
+Rare cards should feel distinctive.
+
+### Border
+
+- Decorative frame.
+- More custom ornament.
+- Symbolic motifs related to the subject.
+
+### Color
+
+- Richer jewel-tone palette.
+- More contrast.
+- More use of gold.
+
+### Artwork
+
+- Stronger visual storytelling.
+- More complex stained-glass structures.
+- Multiple meaningful background elements.
+- More deliberate lighting composition.
+
+### Overall Feel
+
+- Distinctive.
+- Collectible.
+- Clearly above the normal card experience.
+
+---
+
+## Extraordinary
+
+Extraordinary cards should feel prestigious.
+
+### Border
+
+- Elaborate framing.
+- Strong illuminated-manuscript influence.
+- More bespoke ornamentation.
+- Larger use of gold.
+
+### Color
+
+- Deep and saturated jewel tones.
+- Broad palette while remaining cohesive.
+- Strong visual contrast.
+
+### Artwork
+
+- Complex composition.
+- Multiple symbolic elements.
+- Richer environments.
+- More detailed stained-glass segmentation.
+- Greater sense of scale or drama.
+
+### Overall Feel
+
+- Prestigious.
+- Elaborate.
+- Immediately special.
+
+---
+
+## Legendary
+
+Legendary cards should be visually unmistakable.
+
+They can break some of the normal card-layout rules while still clearly belonging to the same product.
+
+### Border
+
+- Highly bespoke.
+- Custom symbolic elements related specifically to the card.
+- Extensive but tasteful ornamentation.
+- Rich gilding.
+
+### Color
+
+- Full jewel-tone palette where appropriate.
+- Strong gold accents.
+- Deep color contrast.
+
+### Artwork
+
+- Strong visual storytelling.
+- Multiple symbols connected directly to the subject.
+- Complex stained-glass composition.
+- More dramatic light.
+- More detailed environments.
+- Unique framing or iconography.
+
+### Overall Feel
+
+- Immediately special.
+- Reverent.
+- Iconic.
+- Worth stopping to inspect.
+
+Example:
+
+**David**
+
+Possible visual elements:
+
+- Crown.
+- Harp.
+- Shepherd staff.
+- Sheep.
+- Jerusalem.
+- Star / celestial imagery.
+- Bespoke gold framing.
+- Rich red and blue garments.
+- Complex stained-glass composition.
+
+These elements help tell David's story rather than simply adding decoration for decoration's sake.
+
+![alt text](image-3.png)
+
+
+#### Alt Style - Tapestry
+
+![alt text](image-4.png)
+
+---
+
+# Rarity vs. Physical Treatment
+
+Rarity, material, and finish are separate systems.
+
+This is important.
+
+A Common holographic card should still visually read as a Common card.
+
+A Legendary plain-paper card should still visually read as Legendary.
+
+## Rarity controls
+
+- Graphic design.
+- Frame.
+- Composition.
+- Symbolic storytelling.
+- Base art complexity.
+- Ornamentation.
+
+## Material controls
+
+- The physical substrate of the card.
+- Surface microtexture and roughness.
+- Edge and core appearance.
+- Base reflectivity and perceived weight.
+- Paper, linen, plastic, metal, or wood response.
+
+## Finish controls
+
+- A treatment applied over the material and printed artwork.
+- Selective foil reflection.
+- Holographic spectral response.
+- Coating strength and coverage.
+
+For example:
+
+- Common Paper + Printed Ink Timothy.
+- Common Paper + Foil Timothy.
+- Common Linen + Holographic Timothy.
+- Common Metal + Printed Ink Timothy.
+
+All of them should still use the same underlying Common Timothy card design.
+
+Material and finish should not be treated as an unrestricted Cartesian product. A combination should exist because it has an intentional physical and visual interpretation, not merely because both options are available independently.
+
+---
+
+# Material and Finish Direction
+
+If a collectible property exists, the player should ideally be able to perceive it visually or interactively.
+
+Examples:
+
+- Finish -> visible.
+- Material -> visible.
+- Wear -> visible.
+- Imperfections -> visible.
+- Printing -> visible.
+- Weight -> indirectly observable.
+- Provenance -> inspectable metadata.
+- Population -> inspectable metadata.
+
+The material is the card's substrate. The finish is a treatment applied over that substrate. They should remain independently identifiable when the card moves under light.
+
+---
+
+## Paper
+
+- Matte with fine, irregular fibers.
+- Broad, weak reflection rather than a sharp sheen.
+- Grain should become visible during close inspection without making the artwork noisy.
+
+## Plastic
+
+- Smoother surface.
+- Clear-coated dielectric reflection.
+- A bounded moving highlight should remain visible even with Printed Ink.
+- Cleaner edges.
+
+## Linen
+
+- Raised interlaced warp and weft rather than generic noise.
+- Soft diffuse reflection.
+- Small shaded recesses should help the weave read under moving light.
+- Particularly compatible with tapestry-inspired artwork.
+
+## Metal
+
+- Reflective underprint and a visibly metallic edge.
+- Darker artwork values create deeper engraved grooves; the maximum depth should remain low enough that the card still feels printed and collectible rather than sculpted.
+- Groove depth should read through surface normals, restrained cavity shading, and fine bevel highlights when the card moves.
+- Printed artwork colors must remain recognizable rather than becoming uniformly silver or gold.
+- Visually heavier.
+- Should still preserve artwork readability.
+
+## Wood
+
+- Warm substrate tint with a darker brown core.
+- Longitudinal, slightly warped grain with shallow physical relief.
+- Grain should support the card artwork rather than overpowering it.
+- Reflection should remain restrained and less polished than plastic or metal.
+
+## Foil
+
+- Selective angle-dependent metallic reflection controlled by an art-directed mask.
+- Light should sweep visibly across treated regions without washing out the entire illustration.
+- Foil should remain distinguishable from a Metal substrate: foil is a localized surface treatment, while metal changes the whole card body and edge.
+- Metal + Foil should preserve the printed colors and read as restrained, slightly raised champagne-metal polishing over etched steel. It should not turn the whole illustration into opaque gold.
+
+## Holographic
+
+- View-dependent spectral response.
+- Holographic response should use masks so intentional portions of the artwork react.
+- Should remain tasteful and avoid a neon / fantasy appearance.
+- Spectral color can be clearly visible, but extreme white sheen at grazing angles should remain controlled.
+
+## Finish Mask Direction
+
+- Finish masks should be authored and reviewed as part of the card art rather than treated as arbitrary technical output.
+- Preserve titles, verses, and other critical text unless a specific treatment is intentionally designed for them.
+- Do not create obvious circular or elliptical exclusions around faces, hands, animals, or other subjects. Those shapes read as artificial holes when the card moves.
+- Avoid isolated mask islands that produce unrelated holographic spots across skin or focal features.
+- Prefer coverage that follows stained-glass panes, ornament, borders, garments, environmental color, and other compositional regions.
+- Evaluate every mask while rotating the card under multiple lighting angles. A mask that looks acceptable in a still image may look distracting in motion.
+
+---
+
+# Wear
+
+Wear should not make cards ugly to the point that the artwork becomes undesirable.
+
+Even the lowest wear levels should remain visually readable and collectible.
+
+A 0.00 wear card can be noticeably scratched, worn, or damaged while still looking like a cared-for physical collectible rather than a destroyed object.
+
+Possible classifications are still subject to change, but could look something like:
+
+- Mint.
+- Near Mint.
+- Minimal Wear.
+- Moderately Played.
+- Worn.
+
+Wear can affect:
+
+- Edge whitening.
+- Surface scratches.
+- Small scuffs.
+- Minor print abrasion.
+- Subtle corner wear.
+
+It should not normally obscure:
+
+- Subject identity.
+- Important text.
+- Major portions of the artwork.
+
+Wear patterns should ideally be seeded per card instance so two cards with the same wear value do not necessarily have identical damage.
+
+---
+
+# Printing Variants
+
+Printing should affect the graphic presentation of the same card identity.
+
+## Normal
+
+- Standard frame.
+- Name.
+- Subtitle.
+- Short verse / quote / fact.
+- Normal artwork area.
+
+## Borderless
+
+- Artwork extends farther toward the card edges.
+- Reduced frame.
+- Minimal text treatment.
+
+## Textless
+
+- Artwork-focused.
+- Little or no text.
+- Educational information remains available in the inspection panel.
+
+## Boundless
+
+- Full-bleed or near-full-bleed artwork.
+- Minimal or absent conventional frame.
+- Intended to feel like a special printing rather than a higher rarity.
+
+Printing type should not change the underlying rarity of the card.
+
+---
+
+# Thumbnail Readability
+
+All normal card designs should remain recognizable in a binder or collection grid.
+
+At thumbnail size, the user should ideally still be able to identify:
+
+- The subject or general composition.
+- The card rarity through its frame language.
+- Major color identity.
+- Whether the card has an unusual printing or finish when practical.
+
+Fine text does not need to remain readable at thumbnail size.
+
+The card name should become readable as the card grows larger or when selected.
+
+---
+
+# Pack Opening Art Direction
+
+Pack opening should create anticipation without feeling like a casino.
+
+Rarity can affect reveal pacing and presentation.
+
+Possible progression:
+
+## Common
+
+- Simple lift.
+- Quick flip.
+- Minimal lighting change.
+
+## Uncommon
+
+- Slight pause.
+- Mild environmental emphasis.
+
+## Rare
+
+- More deliberate reveal.
+- Stronger lighting transition.
+- Small audio / visual flourish.
+
+## Extraordinary
+
+- More dramatic reveal timing.
+- Larger environmental shift.
+- More pronounced presentation.
+
+## Legendary
+
+- Unique or near-unique reveal treatment.
+- Strong visual emphasis.
+- Longer anticipation, but still skippable.
+
+The goal is:
+
+> **Rarity can affect anticipation without going full casino.**
+
+All reveal animations should remain skippable.
+
+---
+
+# Things to Avoid
+
+Across all rarities:
+
+- Hyper-photorealistic character portraits.
+- Anime styling.
+- Comic-book styling.
+- Neon fantasy effects.
+- Generic fantasy RPG framing.
+- Excessive glowing particles.
+- Overly busy ornament.
+- Illegible typography.
+- Decorative detail that makes the subject harder to identify.
+- Making every card look premium.
+- Using rarity only as a glow / particle intensity slider.
+- Turning historical Christian art into parody.
+- Making Common cards deliberately ugly.
+
+The distinction should be:
+
+> **Common is simple. Legendary is elaborate.**
+
+Not:
+
+> **Common is bad. Legendary is good.**
+
+---
+
+# MVP Art Goals
+
+For the MVP, I do not need every card to be a full-scale art project.
+
+The interesting part is proving that the entire visual system works.
+
+The MVP should establish:
+
+- A consistent stained-glass-inspired card style.
+- A clearly readable rarity system.
+- A reusable card layout system.
+- At least one working example of each rarity.
+- Multiple materials.
+- Multiple finishes.
+- Multiple printing types.
+- Wear.
+- 3D card inspection.
+- Light-reactive materials.
+- Pack-opening presentation.
+- Thumbnail / binder representations.
+
+I think it makes more sense to create a smaller number of highly intentional art examples and then build the other cards from the same visual system rather than independently designing all 50 cards.
+
+---
+
+# Open Art Questions
+
+Things that still need to be explored:
+
+- Exact card dimensions / aspect ratio.
+- Final typography.
+- Exact color palette.
+- Whether each rarity has a fixed base frame or a family of frames.
+- Whether card categories have their own secondary visual motifs.
+- Whether tradition-specific cards alter UI or border accents.
+- Exact visual treatment for controversies.
+- Whether halos should be used based on historical iconography, card category, tradition, or purely artistic composition.
+- How much motion should exist inside holographic cards.
+- Exact distinction between Extraordinary and Legendary.
+- Whether higher-rarity cards are always visually more complex or occasionally gain prestige through extreme simplicity.
+- How much the card artwork itself changes across printing variants.
+- Final card back design.
+
+---
+
+# Current Direction Summary
+
+The current visual north star is:
+
+> **Stained glass first. Tapestry and illuminated manuscript second. Sacred and stylized throughout.**
+
+Rarity should be obvious through design language before the user reads a label.
+
+Common cards should be restrained and humble.
+
+Legendary cards should feel bespoke and narratively rich.
+
+Finishes and materials should enhance the physical card without replacing rarity as the primary graphic hierarchy.
+
+The cards should be beautiful enough to want to collect, but the overall product should always remain reverent rather than flashy.

docs/functional-spec-v1.md

@@ -0,0 +1,358 @@
+# Christian Habit Tracker TCG - Functional Spec
+
+I think a good name for the application would be Sanctification TSG; as the objective is to grow in Christ and move towards holiness.
+
+Scenario: Habit trackers are super common place and incredibly overdone. I find the same issue with every single one of them - tracking your habits needs to be a habit itself. Many applications try to add a "carrot" but nothing actually seems to provide a good sense to really reel you back in.
+On the opposite front, bad habits don't really have a negative attached to them. 
+
+One thing that has become hugely popular is TCGs - more importantly card openings. This idea that you can collect the cards and try to obtain rare instances or wide variations of said cards.
+
+All these card games are typically built in their own universe - but I want to do it christian themed.
+
+Below breaks this down into the large functional pieces of the project - and the unknowns that may need to be explored
+
+
+## Christianity
+
+At the core foundation, we believe to be Christianity is founded in the words and logic of the Nicene Creed, as follows:
+
+"We believe in one God the Father Almighty, Maker of heaven and earth, and of all things visible and invisible.
+
+“And in one Lord Jesus Christ, the only-begotten Son of God, begotten of the Father before all worlds, God of God, Light of Light, Very God of Very God, begotten, not made, being of one substance with the Father by whom all things were made; who for us men, and for our salvation, came down from heaven, and was incarnate by the Holy Spirit of the Virgin Mary, and was made man, and was crucified also for us under Pontius Pilate. He suffered and was buried, and the third day he rose again according to the Scriptures, and ascended into heaven, and sitteth on the right hand of the Father. And he shall come again with glory to judge both the quick and the dead, whose kingdom shall have no end.
+
+“And we believe in the Holy Spirit, the Lord and Giver of Life, who proceedeth from the Father, who with the Father and the Son together is worshiped and glorified, who spoke by the prophets. And we believe in one holy catholic and apostolic Church. We acknowledge one baptism for the remission of sins. And we look for the resurrection of the dead, and the life of the world to come. Amen"
+
+## Functional Break Down
+
+### TCG
+
+The whole premise of the "game" is just collection. This would become the carrot of your habits and hope to build something a bit more fun and community into the service.
+
+Daily login would bring in daily packs and each task can also give the daily packs or even special rare packs (that have slightly boosted numbers - or even guaranteed) for different tasks/streaks/achievements etc.
+
+In terms of how we want to calculate rarity and mathematics, I want to make it so that if you want to collect every single card yourself, it should take something like at least a year of consistent with doing each task.
+    * if you do collect all cards (regardless of quality, etc), I think i might be cool to have some kind of prestige system. Maybe decorates profile/binder?
+
+I was thinking that if you somehow are able to complete the full compendium (not the types) then you can do it in like 1 year. (subject to change depending on feedback)
+
+#### Binders
+
+Everyone gets a binder that holds their entire compendium that they can look through (or others can look at)
+
+Later more binders and different kinds of card holders can be unlocked from achievements or small microtransations - I haven't decided
+    * This would allow people to collect different types (all metal, all holo, all foil, etc, etc)
+
+#### The Packs
+
+* Streaks
+    * Weekly/monthly streaks will provide higher quality packs.
+
+* Not sure yet but I would want different kinds of packs that provide boosted chances at the better tiers/values
+    * Common - normal color foil
+    * Gold
+    * Illuminesent
+
+* Different packs would have different opening animations
+* You can choose to have all in a row and clicking each card to flip them
+    * Or you can have them stacked and flip them going from front to back.
+    * You can also have just auto open which just opens and start flipping all of them in an animation.
+
+#### The Cards
+
+* Different flavors of cards (different decks) - they would share common cards (common not as in tier but rather common theology)
+    * Catholic
+    * Orthodox
+    * Protestant
+    * Heretic
+
+* Different Tiers (I want to find better Biblical names for tiers)
+    * Common
+    * Uncommon
+    * Rare
+    * Extraordinary
+    * Legendary 
+    * Trinity - Highest tier - only The Father, The Son, and The Holy Spirit
+
+* Quality - To make the trading aspect fun and always continuous cards pulled will also roll different qualities on a log scale (or some kind of mathematical scale we think about) - maybe even normal graph for things like the wear
+    * Wear
+        * Every card unpacked would have a float value between 1.00 and 0.00. 1 would be prestine but 0 would be very worn out.
+        * Legendary and Trinity (or I guess if we add any other really high tiers would be float locked to being higher)
+    * Finish - matte/glossy/textured/holographic/foil
+        * Very small chance for different kinds of holographic/foils - also float capped
+    * Printing
+        * Normal, Borderless, Textless, Boundless
+    * Material
+        * Paper, plastic, wood, linen, metal
+    * Weight
+        * All cards would be about 100g with light variance but things like holographic/foil would add a minor amount of weight
+        * We could have an achievement system that let's you get a small digital scale so you can weigh the pack to make for more fun unpacking.
+    * Imperfections
+        * This one is still a maybe - we can generate a couple of masks that look like finger prints, hair, etc. for the card that has a very small change to be added to imperfections
+        * Trinity cannot have imperfections.
+
+* Content
+    * I would want to shoot to have a very large repository of cards
+    * The cards would have different categories: people, history, icon, item, place, event, theologions, theorems (apologetics), etc.
+        * The greater the impact of that card in Biblical history the higher the tier.
+        * So more obscure people would be put into common (even something like "man") while someone like David would be considered Legendary (could be extraordinary).
+            * Something like Gabriel or Michael would be also legendary
+    * Unless a specifically type of card (like textless), every card would have some kind of text associated with it
+        * The text must be something related to that card - whether a verse, quote, or historical fact (priority in that order)
+        * The text would also have a link when clicked on to allow you to learn more or see why.
+
+* Cards also retain metadata about when it was open and who opened it. Maybe we could also track how many cards of that kind (card id/finish/printing/material) - with this you can tell if you have a 1 of 1 metalic holographic normal print Adam or if there were already 1000 pulled. Weight/wear/imperfections wouldn't go into this.
+
+* Art style
+    * I still haven't decided how I want the art/cards to look. Just need to AI generate a few options to get a common design
+    * Card favors would affect the colors, borders of the cards, and back art of the cards.
+
+### Habit tracking
+
+Ultimately this would be habit tracker at its base.
+
+#### Honor system
+
+I think an important aspect to outline is that ultimately this is a tool to build essential habits with God and the community/fun aspect is second nature. 
+How or whether someone actually is doing what they are tracking is between them and God - and with accountability partners if they choose to do that.
+
+What is means to complete a task is also between the user and God. If prayer for them means 5 minutes or 1 hour, that is fine. BUT I think we should outline (maybe during first time) that trying to say a 5 second prayer before entering the app is not qualification. It is a matter of the heart - not to gamify things. 
+
+#### Positive Habit Tracking
+
+I think initially we will start with a couple of base good habits to build on:
+* Prayer
+* Bible reading
+* Weekly church attendance - Weekly tasks would give a different kind of pack - or maybe we just give you the option to chose a type of common pack
+* Study - this would be something like a devotional, a chapter of christian literature, or digging into theology
+* Volunteering ?* - not sure how to track this cadence. Doesn't feel like a daily thing but also a category of things that builds a christian value
+
+You can always log up to the day prior to recieve your card pack 
+    * You can always log previous days/weeks of progress towards your habits but you will not recieve packs for those. (Streaks will also be reset)
+
+#### Negative Habit Tracking
+
+I want there to be an option to track bad habits that someone may have. These can be custom input although we will provide some base line ones like: lust, addiction (smoking, drinking), anger, etc.
+
+This will track separately from the positive habits that the user is trying to break. 
+They can open up the exact issues to accountability partners or more generic message "Like, X user needs your prayer :)"
+
+As for if you do track your negative habits, whenever you break your streaks, you will need to burn one of the cards at random. That card would be gone forever.
+My thought on this is it would help provide a tangible reaction to what happens. 
+
+BUT after each broken streak, we would provide messaging that the user is still loved and Christ died for our sins but we must repent and choose to grow with Christ
+
+### Social Interaction
+
+The other important aspect of card collections is trading.
+In general having a community that you can hook into. Where you can have friends and even accountability partners (friends don't necessarily mean accountability partners as some people might rather choose to keep anonimity)
+
+No chat integration - this would require too much moderation and other things that can take away resources.
+You can send each other pre-determined messages of encouragement, you can send any verse (I guess you can technically make it bad but I think we will trust in good faith for this), or pre-determined messages to help with
+
+Functionalities I think would be great:
+* View other people's compendium.
+* Offer trade
+* All habit tracking will be private except can be opened up to accountability partners. 
+    * This avoids hubris or shame - that is not the point of the project.
+
+#### Integrations
+
+I was thinking to provide API and webhook support so it can be integrated into anything at that point. Something like a Fluxer bot (Discord also)
+
+Other integrations I am not sure yet.
+
+### Application
+
+
+Reorganize to:
+
+1. Product principles
+2. User journeys
+3. Core gameplay loop
+4. Habit model
+5. Reward/economy model
+6. Card definition
+7. Card instance/variant model
+8. Collection/binder
+9. Social/trading
+10. Accountability/privacy
+11. Christianity/content policy
+12. Monetization principles
+13. MVP
+14. Future systems
+15. Open questions
+
+
+Application
+└── React / Next.js
+    ├── Normal UI
+    │   ├── habits
+    │   ├── profile
+    │   ├── trading
+    │   ├── settings
+    │   └── binder navigation
+    │
+    └── React Three Fiber
+        └── Three.js
+            ├── card inspector
+            ├── pack opening
+            ├── binder card interactions
+            └── collection showcase
+
+Asset pipeline
+└── Blender
+    └── GLB / glTF
+        ├── geometry
+        ├── base materials
+        ├── normal maps
+        └── other PBR maps
+
+
+### Card Interaction
+
+Cards should be represented as tactile physical objects rather
+than static collectible images wherever practical.
+
+When inspecting a card, the user must be able to:
+
+- Rotate the card freely.
+- Flip between front and back.
+- Zoom in to inspect artwork and physical characteristics.
+- Observe material properties responding dynamically to lighting.
+- Observe wear and imperfections where applicable.
+- Return quickly to the originating collection/binder context.
+
+Card finish and material must have visually distinguishable
+properties. For example, foil, holographic, paper, linen, and
+metal cards should respond differently to lighting.
+
+Lower-power devices must be able to fall back to simplified
+visual representations without affecting gameplay.
+
+## Initial Technical Direction
+
+Frontend:
+React / Next.js
+
+3D:
+Three.js via React Three Fiber
+
+Asset authoring:
+Blender
+
+Asset format:
+glTF / GLB
+
+Rendering:
+WebGL2 baseline
+WebGPU optional
+
+Card architecture:
+Shared geometry + runtime textures/material parameters
+
+
+
+
+
+
+
+honesty vs. the economy 
+    * I don't think this is as big of a problem. I would build the rarity and economy as if everyone did earnestly do every single task and complete every streak
+        * If people miss or don't, then the economy would just not develop as quickly
+        * If people lie, that is fine because that is technically my baseline (as I want everyone - including myself - to be in a place where you can truthfully say you take care of it all the time)
+    * "Five minutes of prayer shouldn't mint less valuable cards than sixty minutes, because you'd immediately incentivize exaggerated reporting."
+        * Yeah. I thought that is what I outlined in the functional spec. We would give guidance in messaging but a whole day in prayer doesn't give you anything more than 5 minutes or lying. But it is habit tracking afterall.
+
+Privacy
+    * I think we just need to ensure encryption on all customer data. Server cannot read customer content. We can do statistics but things like sin/anethema would be encrypted. Maybe something like BYOK to ensure server admin really can't just look in the DB
+    * Accountability is obscure by default.
+
+Negative-habit punishment
+    * I actually fully agree with you on this.
+    * I like both the Abstinence streak and the honesty/engagement aspect
+    * I like recovery milestones
+    * Every fall needs to be met with grace and good messaging
+    * Every milestone needs to be celebrated (not with packs - we don't want to promote any kind of side thing)
+    * I still like the concept of burning the card but ceremoniously or voluntarily would be great!
+
+Streaks
+    * You're right. I don't think we do streaks - consistency is a stronger metric.
+
+Shared core plus traditions
+    * I like this. Puts strong emphasis on learning but keeps the divide
+    * I do want to make sure to keep things like Mormonism and JW (for example), in the controversies
+
+Trinity
+    * This is just something I was initially rumiating about; I agree that it doesn't have a place in this as I wrote originally.
+    * What if instead - during the tutorial (or if you skip tutorial) - the Trinity would be given to you as your first and permanent card.
+        * This symbolizes the core aspect that Christ is always with us and is a gift we do not lose (theology here obviously differs but point stands).
+        * You can customize it to whichever finish etc you like. It will always be in mint condition.
+        * Thoughts on verse? I almost think John 3:16 - seems like a pretty decent fit.
+    * But having Trinitarian other concepts is nice too but I think the meaning here is good.
+
+Rarity should probably not mean spiritual importance
+    * I agree on the prominence within the collection
+    * It was an initial idea I wanted to start with but didn't come to a full idea of what that might be    
+    * "And perhaps some sets have independent rarity structures." <- I think this is great too. 
+
+Monitization
+    * I genuinely have no real plan to make money off this. I half mentioned it if this were to somehow blow up in popularity.
+    * My current plan is to build it out and try it with my friends
+    * ABSOLUTELY no loot boxes. Gambling already ruins lives and that would be an anethema to what I'm trying to accomplish
+
+Login pack
+    * I still need to deliberate on how I want to give packs and how many cards per pack and statistics behind that.
+    * Login pack helps establish the initial hook. When in the app (or could before), you now might realize, "Oh right. I need to actually accomplish my tasks"
+    * I'm also still not sure if we should give pack per task or upgrade the pack per task
+        * Hmmm. What if that is the case? The login pack has reaally bad odds. You do your dailies and other tasks and it upgrades your pack.
+        * This way you still have the hook, if they choose to just open it - the odds are bad or maybe we just heavily increase the wear chance.
+
+Random thoughts
+    * You can also choose to save packs to open later - if you want to open many at once or on occasion.
+
+MVP
+    * I like the idea of fleshing out the MVP.
+    * I'm a software engineer - not an artist or 3D modeler - so I'll be leaning on LLMs (MCP servers) for help on those pieces
+    * There is not true deliverable so I think just making like 50 cards but trying to do all the difficult stuff with the cards is what is interesting to me
+        * The canvas and rendering will also be interesting tech challenges
+    * Wiring up a backend to client and handling all those other pieces are much easier to me and will be addressed in tech spec
+
+
+Product philosophy
+    * Completion/honesty/consistency/return from failure are all core concepts
+
+Is the collectible system subordinate to the habits, or equally important?
+    * I think the collection system is what makes the habit tracking unique - if I wanted habit tracking, I can do with pen/paper or just download any one of the 1000 apps that already do so.
+
+Christianity
+    Who determines whether card content is doctrinally acceptable?
+    Is the standard strictly Nicene? Yes - for now. Subject to change
+
+    Would a Catholic-specific card be visible to an Orthodox user? Yes
+    Can users choose traditions? No - maybe they can change UI to match tradition (addon?)
+    Can users collect every tradition? Yes - I want people to also learn
+
+What constitutes a unique card?
+    CardIdentity
+    Artwork
+    Rarity
+    Finish
+    Printing
+    Material
+    Wear - but in percentages so Mint might be like 1.00 - .95, Minimal Wear .95 - .75, etc etc,
+
+Economy
+    * I think those can come in the future - Let's work on this area specifically
+    * Maybe we have a way to allow essentially destruction of cards - use up like 20 common cards to generate a uncommon. Similar to CounterStrike trade ups
+    * Allows for also removing things from the pool
+
+Are pack probabilities globally fixed or dynamic?
+    * Fixed - maybe we wire in the variables to allow for dynamic in future if we feel the numbers aren't working as expected
+
+What experience do you want someone to have the morning after they fail badly?
+    * We treat with grace. Tell them that we are excited to have them back and every journey begins with the first step
+
+Structural change
+    * I like the structural change.
+
+I like the idea for the technical spike of flutter scene versus Three.js