Imported from kirantikoo/craftverse-frontend (
AGENTS.md). Install upstream withnpx skills add kirantikoo/craftverse-frontend. Copyright stays with the author.
CraftVerse AGENTS.md
Version: 1.0 Status: Long-Term Master Plan Project Owner: Sonu Platform: CraftVerse Website: (To be added) Repository Structure:
- craftverse-frontend
- craftverse-backend
- craftverse-admin
Vision
CraftVerse is an AI-powered Art & Craft Learning Platform where anyone can learn, create, teach, sell, and build a creative business.
Unlike YouTube, CraftVerse provides an interactive AI tutor that guides learners one step at a time, checks their work using AI, and unlocks the next lesson only after successful completion.
The long-term goal is to become the world's largest AI-powered platform for crafts, sewing, crochet, knitting, embroidery, DIY, painting, woodworking, resin art, paper crafts, jewelry making, and many more creative skills.
Core Philosophy
One Tutorial ↓
Many Outputs
A creator should create content only once.
CraftVerse automatically generates:
• Interactive AI lessons • Website course • Mobile lesson • AI Tutor • Long YouTube video • YouTube Shorts • Instagram Reels • Facebook Reels • Pinterest Pins • Blog articles • SEO pages • PDF guides • Email newsletters • Quizzes • Certificates • Marketing content
Everything comes from one structured source.
The CraftVerse Difference
Traditional Platforms
Watch video ↓
Try yourself ↓
Get stuck ↓
Leave
CraftVerse
Watch Step 1 ↓
Click Done ↓
Upload Photo ↓
AI Checks Work ↓
AI Gives Feedback ↓
Fix Mistakes ↓
Unlock Step 2
This creates a real teacher-like experience.
AI Tutor Workflow
Each lesson contains:
Step Video
Voice-over
Text Explanation
Materials
Tools
Safety Tips
Hints
Common Mistakes
Photo Upload
AI Image Validation
Alternative Methods
Material Substitutions
Why This Step Matters
Quiz
XP Reward
Certificate Progress
Completion Badge
AI Features
AI Vision
Learner uploads photo.
AI checks:
- Stitch quality
- Alignment
- Pattern accuracy
- Yarn tension
- Missing stitches
- Incorrect colors
- Measurements
- Object shape
- Completion percentage
Returns:
✔ Great job
or
❌ Try again
with detailed feedback.
AI Coach
User asks:
"I'm stuck."
AI explains the step differently.
Can generate:
Text
Images
Animations
Mini videos
AI Material Helper
"I don't have cotton yarn."
AI suggests alternatives.
AI Question Answering
Users can ask:
Why?
How?
What if?
Can I replace this?
Why is mine different?
AI answers based on tutorial context.
Master Content System
Every tutorial is stored as structured JSON.
Tutorial
Title
Description
Category
Difficulty
Duration
Materials
Tools
Safety
Steps
Thumbnail Prompt
SEO
Social Media
Quiz
Voice-over
Video Prompt
Validation Rules
Completion Rewards
This JSON becomes the single source of truth.
Creator Studio
Creators can:
Upload videos
Create tutorials
Sell digital products
Sell craft kits
Sell patterns
Sell templates
Sell premium courses
Manage students
View earnings
Receive analytics
Generate AI content automatically
Content Automation
From one tutorial automatically create:
Website lesson
AI lesson
Long video
Short video
Instagram Reel
Facebook Reel
Pinterest Pin
Blog
Newsletter
Quiz
Thumbnail
Transcript
Captions
SEO
Metadata
Voice-over
Creator Marketplace
Every creator gets:
Public profile
Followers
Ratings
Courses
Products
Reviews
Achievements
Creator dashboard
Income analytics
Verified badge
Founding Creator Program
First 100 creators receive:
Verified badge
Priority ranking
Lifetime recognition
Lower platform commission
Direct feedback channel
Early feature access
Exclusive promotions
Learning System
Categories include:
Crochet
Knitting
Sewing
Embroidery
Macrame
Painting
Drawing
Resin Art
Paper Crafts
Origami
DIY
Woodworking
Leather Craft
Jewelry Making
Home Decor
Kids Crafts
Fashion Design
Quilting
Pottery
Many more...
XP System
Users earn XP for:
Watching lessons
Completing steps
Passing quizzes
Uploading photos
Helping community
Daily login
Challenges
Projects
Certificates
Badges unlock levels.
Community
Forums
Groups
Challenges
Competitions
Monthly themes
Creator live streams
Student galleries
Comments
Likes
Following creators
Messaging
Shop
Creators can sell:
Patterns
Templates
Craft kits
Digital downloads
Finished handmade products
Courses
Subscriptions
Bundles
Gift cards
Affiliate products
Revenue Model
Free Plan
Limited tutorials
Community access
Basic AI
Advertisements
Premium Plan
Unlimited AI Tutor
Premium courses
Certificates
Offline mode
Downloads
Advanced feedback
Exclusive community
Monthly subscription
Country-based pricing
Stripe integration
Creator Revenue
Revenue sources:
Course sales
Pattern sales
Product sales
Subscriptions
Affiliate income
Craft kits
Brand sponsorships
Tips
Marketplace
Possible revenue split:
Creator: 85–90%
CraftVerse: 10–15%
Marketing Strategy
Primary channels:
YouTube
TikTok
Blog
SEO
Every tutorial generates content for all platforms.
YouTube Strategy
Long tutorials
Shorts
Beginner series
Advanced series
Craft hacks
Tips
Behind the scenes
AI-generated voice
Multilingual subtitles
Channel drives users back to CraftVerse.
Instagram Strategy
Reels
Stories
Carousels
Before/After
Daily tips
Community highlights
Creator features
Pinterest Strategy
Pins
Idea Pins
Step graphics
Material guides
Download links
SEO Strategy
Every tutorial creates:
Dedicated webpage
Structured data
FAQ
Blog
Images
Keywords
Metadata
Internal links
Technology Stack
Frontend
Next.js
TypeScript
Tailwind CSS
Framer Motion
Backend
API Architecture
Authentication
Firebase Auth
Database
Firestore initially
Architecture designed so migration to PostgreSQL is possible later.
Storage
Firebase Storage
Payments
Stripe
Analytics
Google Analytics
AI
OpenAI APIs
Vision APIs
Video Generation APIs
Image Generation APIs
Voice APIs
Translation APIs
Repository Structure
craftverse-frontend
Customer website
Learning
Community
Shop
Dashboard
craftverse-backend
REST APIs
Authentication
Tutorial Engine
AI Engine
Creator APIs
Payments
Notifications
craftverse-admin
Manage creators
Moderate content
Approve tutorials
Analytics
Reports
Revenue
Users
Development Roadmap
Phase 1 – Foundation
✓ Branding
✓ UI/UX
✓ Landing page
✓ Authentication
✓ User dashboard
✓ Creator dashboard
✓ Pricing page
✓ Dark/Light mode
✓ Responsive design
Phase 2 – Learning Platform
Tutorial pages
Progress tracking
Categories
Bookmarks
Favorites
Search
Filtering
Certificates
XP
Achievements
Phase 3 – AI Tutor
Interactive lessons
Step locking
Photo upload
AI feedback
Hints
AI explanations
Progress saving
Phase 4 – Creator Studio
Upload tutorials
Tutorial builder
JSON editor
Analytics
Revenue dashboard
Product management
Phase 5 – Marketplace
Digital downloads
Patterns
Products
Craft kits
Subscriptions
Affiliate products
Reviews
Wishlist
Phase 6 – Community
Groups
Challenges
Messaging
Creator following
Feeds
Notifications
Live events
Phase 7 – AI Automation
Auto video generation
Auto thumbnails
Auto blogs
Auto SEO
Auto social posts
Auto translations
Auto subtitles
Auto quizzes
Auto voice-over
Phase 8 – Mobile Apps
Android
iOS
Offline learning
Push notifications
Camera AI
Downloads
Phase 9 – Global Expansion
Multiple languages
Country pricing
Regional creators
International shipping
Regional content
Long-Term Mission
Become the world's leading AI-powered creative learning ecosystem where:
Students learn interactively.
Creators earn sustainably.
Businesses sell products.
AI assists every step.
One tutorial powers every platform.
CraftVerse becomes the complete ecosystem for the global creative community.