Help & How-To Guide - CKI Interactive Kabbalah Study Companion

🌟 Getting Started

New to the Study Companion?

Follow these simple steps to begin your journey into Kabbalistic wisdom.

Your First Steps:

Explore the Tree: Click on any sefirah (sphere) to see its meanings, colors, biblical figures, and divine names
Try the Paths: Click "Show Paths" and then click Hebrew letters to learn about the 22 connections
Start Searching: Use the Search tab to find specific concepts, figures, or colors
Compare Sefirot: Use the Compare tab to examine relationships between different spheres
Begin Studying: Try the Study tab to track your learning and add personal notes
Practice Meditation: Visit the Practices tab for guided meditations

Understanding the Interface

🌳 Explore Tab

Your main gateway to the Tree of Life. Click any sefirah to see comprehensive information including divine names, colors, biblical figures, and spiritual activities.

🔍 Search Tab

Powerful search across all content. Find specific Zohar citations, biblical figures, colors, or any concept in the database.

📜 Citations Tab

Access the complete database of Zohar references organized by sefirah with context and scholarly commentary.

⚖️ Compare Tab

Side-by-side analysis of up to 3 sefirot, showing relationships, commonalities, and connected paths.

🔧 Features Overview

Clickable Sefirot: Each sphere is fully interactive with comprehensive information

Color-Coded Design: Traditional color associations with visual appeal

Responsive Layout: Works on desktop, tablet, and mobile devices

Hover Effects: Visual feedback as you explore

Complete Path Network: All 22 paths with Hebrew letters and correspondences

Interactive Hebrew Letters: Click any letter circle to see detailed path information

Path Filtering: Show/hide paths by category (Mother, Double, Single letters)

Tarot Integration: Each path includes its corresponding Tarot card

Elemental Associations: Planetary and elemental correspondences for each path

Multi-Field Search: Search across names, colors, figures, activities, and more

Citation Search: Find specific Zohar references by concept or passage

Pattern Analysis: Discover hidden relationships and connections

Cross-Reference Discovery: Automatic detection of thematic links

Personal Bookmarks: Save views and concepts for quick reference

Study Notes: Add personal insights tied to specific sefirot

Session Tracking: Monitor study time and focus areas

Guided Paths: Structured learning sequences for different levels

Progress History: Review past sessions and track development

Sefirah-Specific Meditations: Guided practices for each sphere

Daily Practices: Morning orientation, gratitude, walking meditations

Sacred Breathing: Divine name breathing techniques

Practice Timer: Customizable meditation timer with interval bells

Practice Tracking: Monitor meditation frequency and preferences

⚙️ Content Management

Important: Always Backup First!

Before making any changes, always export your data using the Admin interface. This ensures you can restore if something goes wrong.

Method 1: Using the Admin Interface (Recommended)

Click the "⚙️ Admin" button in the top toolbar
Enter the password: kabbalah2025
Use the forms to edit sefirot properties, add citations, or manage content
Always use "Export All Data" to backup before major changes
Use "Import Data" to restore from backups if needed

Method 2: Direct File Editing

For advanced users, you can edit the JSON files directly:

File Structure:

data/
├── sefirot.json      # All sefirah information
├── citations.json    # Zohar citations
├── paths.json       # The 22 paths
├── sources.json     # Extended sources
└── practices.json   # Meditation practices
            

JSON Editing Rules:

✅ Correct Syntax

"name": "Keter"
["item1", "item2"]
{"key": "value"}

❌ Common Mistakes

name: Keter
'name': 'Keter'
["a", "b",]

Validation & Safety

After making changes, always validate your data:

Open your website
Press F12 to open developer tools
Type: dataValidator.displayResults()
Fix any errors shown before continuing

📚 Study Guide by Experience Level

🌱 Beginning Students

Start with Malchut: The foundation sphere, closest to physical reality
Use Daily Practices: Begin with simple morning orientations
Follow the Beginner Journey: Structured path through the sefirot
Practice Basic Meditation: 5-10 minute sessions with the timer
Explore Colors and Figures: Use search to understand symbolic associations

🌿 Intermediate Students

Compare Related Sefirot: Use the Compare tab for Hesed vs Gevurah, Netsach vs Hod
Study the 22 Paths: Learn Hebrew letters and their mystical meanings
Dive into Citations: Read Zohar passages for deeper understanding
Practice Path Meditations: Work with specific path energies
Track Your Studies: Use the Study tab to monitor progress

🌳 Advanced Students

Research Citations: Use the database for scholarly work
Analyze Patterns: Look for hidden correspondences across systems
Create Custom Paths: Design your own study sequences
Integrate Sources: Connect Kabbalistic concepts with broader Jewish learning
Teach Others: Use the Compare and Export features for presentations

🔧 Troubleshooting

Common Issues

Possible Causes & Solutions:

Browser Cache: Clear your browser cache and refresh
JavaScript Disabled: Enable JavaScript in browser settings
File Path Issues: Ensure all files are in the correct directories
JSON Syntax Error: Check browser console (F12) for error messages

Quick Fix: Try opening in a different browser to isolate the issue.

Chrome-Specific Issues:

Chrome sometimes has layout rendering problems. If tabs appear stacked vertically:

Clear browser cache completely
Disable browser extensions temporarily
Try Firefox or Safari to confirm it's Chrome-specific
Check console for CSS-related errors

Data Integrity Issues:

Run validation: Press F12, type dataValidator.displayResults()
Check for typos in JSON files
Verify all quotes and commas are correct
Restore from backup if needed
Check file permissions (if using local server)

Admin Access Issues:

Verify password: kabbalah2025
Check for JavaScript errors in console
Try clicking outside the panel first, then reopening
Refresh the page and try again

Timer Issues:

Check browser audio permissions
Ensure browser allows sound/notifications
Try a different browser
Check if JavaScript is enabled

Getting Help

When Requesting Support, Include:

What you were trying to do
What happened instead
Any error messages from browser console (F12)
Browser name and version
Whether you made recent changes to data files

🎓 Advanced Features

Data Export & Backup

The system provides multiple ways to backup and export your content:

📄 PDF Export

Create beautiful PDF documents of sefirah information, comparisons, or citations for offline study or sharing.

💾 JSON Backup

Export all data as JSON files for complete backup or migration to other systems.

🔄 Data Import

Restore from backups or import enhanced datasets while maintaining data integrity.

Customization Options

Adding Biblical Figures:

"biblicalFigures": ["Abraham", "Isaac", "NewFigure"]

Adding Zohar Citations:

{
  "reference": "Zohar 3:15a",
  "concept": "New concept",
  "context": "Detailed explanation"
}

Modifying Sefirah Properties:

"meaning": "Updated spiritual significance"

For Best Performance:

Use a local web server (Python: python -m http.server)
Enable browser caching
Keep JSON files well-formatted
Regularly validate data integrity
Clear browser cache after major updates

The system is designed to work with:

Academic research databases
Other Jewish learning platforms
Presentation software (via PDF export)
Personal note-taking applications
Study group collaboration tools