01 Source Code Only
₹99
One-time Payment
- Complete project source code
- Database / data resources
- Dependencies & configuration
- README / setup guide
- Instant download access
NODE-JS Project
Smart AI Tattoo Studio Platform Final Year Project Source Code
Get runnable Smart AI Tattoo Studio Platform Final Year Project Source Code with database files, project setup instructions, live demo options and installation support. This project resource helps students understand the implementation, modules, workflow and technical architecture of a complete NODE-JS project.
Choose the Package That Fits You Best
Simple pricing. Instant access. Secure checkout.
02 Code + Setup Support
₹248
One-time Payment
- Everything in Source Code plan
- Remote setup assistance
- Database & configuration setup
- Run verification
- Help via WhatsApp / Email
Project's Overview
Smart AI Tattoo Studio Platform is a complete MERN Stack tattoo studio management and client-engagement application that combines a public tattoo website, design catalog, artist profiles, tattoo appointment booking, AI-assisted tattoo tools, virtual tattoo try-on, body placement simulation, healing tracking, loyalty management, tattoo passports, reviews, flash drops, competitions, community features, and a complete Admin Panel.
Visitors can browse tattoo designs, artists, flash drops, community content, studio information, and pricing estimates. Registered clients can use AI tools, save concepts, book tattoo appointments, upload reference images, use virtual try-on, create tattoo-builder drafts, simulate tattoo placement, manage wishlist items, track bookings, receive tattoo passports after completed sessions, maintain healing logs, submit showcase images, review artists, redeem loyalty rewards, and receive notifications.
The project includes optional OpenAI integration for AI-assisted tattoo workflows such as tattoo design concepts, tattoo meanings, stories, memory-based concepts, couple tattoo matching, style conversion, tattoo transformation, artist matching, and consultation chat. If an OpenAI API key is not configured, the application can provide structured mock responses for demonstration and development.
The Admin Panel allows complete management of bookings, appointment slots, availability blocks, designs, artists, tattoo taxonomy, users, tattoo passports, healing entries, flash drops, showcase submissions, competitions, Tattoo of the Month, reviews, loyalty rules, rewards, notifications, branding, website content, AI configuration, pricing rules, and JSONL reports.
This project is suitable for B.Tech, M.Tech, BCA, MCA, BE, ME, BSc, MSc, Computer Science, Information Technology, Artificial Intelligence, Web Development, and MERN Stack students searching for a practical final year project, major project, minor project, source code, and project report related to tattoo studio management, appointment booking, AI tattoo design, virtual tattoo preview, customer engagement, OpenAI integration, and full-stack web development.
Login Credentials
Administrator
| Field | Value |
|---|---|
[email protected] |
|
| Password | Admin@123 |
User
| Field | Value |
|---|---|
[email protected] |
|
| Password | User@123 |
Related & Popular Projects
View all
Admin Dashboard
The Admin Dashboard includes:
-
KPI counts
-
Recent bookings
-
Revenue based on completed booking
finalPrice -
Quick access to studio modules
Design Management
Admin can:
-
Create tattoo design
-
Upload design image
-
View designs
-
Edit design
-
Replace image
-
Delete design
Artist Management
Admin can:
-
Create artist
-
Upload artist photo
-
Edit artist
-
Activate/deactivate artist
-
Delete artist
-
Manage artist portfolio items
Again, there is no separate artist login panel.
Tattoo Taxonomy Management
Admin can manage complete tattoo taxonomy, including:
-
Tattoo categories
-
Tattoo styles
-
Placement categories
-
Size options
-
Complexity levels
These structures support:
-
Design catalog filters
-
Booking fields
-
Pricing
-
AI assistance
-
Artist matching
Admin Booking Management
Admin can:
-
View all bookings
-
Filter by status
-
Filter by artist
-
Open booking
-
Update status
-
Add notes
-
Update prices
-
Manage workflow
When a booking is moved to Completed, the system can create a Tattoo Passport.
Scheduling Management
Admin scheduling includes:
-
Appointment slots
-
Availability blocks
-
Create slot
-
Delete slot
-
Create block
-
Delete block
User Management
Admin can:
-
Search user by name
-
Search by email
-
View user
-
View recent bookings
-
Activate user
-
Deactivate user
Inactive users cannot access protected functionality.
Flash Drop Management
Admin can:
-
Create flash drop
-
Edit flash drop
-
Delete flash drop
-
View claims
-
Broadcast notification when a new drop is created
Healing Administration
Admin can:
-
View healing entries
-
Add Admin notes/status where supported
-
Monitor post-session recovery records
Showcase Moderation
Admin can:
-
View submissions
-
Approve submission
-
Reject submission
-
Feature approved submission
Review Moderation
Admin can:
-
View reviews
-
Hide review
-
Delete review
-
Moderate public visibility
Loyalty Administration
Admin can manage:
-
Loyalty rules
-
Rewards
-
Loyalty transactions
-
Manual point adjustment
Brand Management
Admin can configure:
-
Studio logo
-
Hero content
-
Studio settings
-
Aftercare information
-
Touch-up settings
-
Other brand information
Website CMS
Admin can update public website content through CMS settings.
AI Configuration
Admin can configure:
-
AI feature flags
-
Prompts
-
Limits
-
Quotas
-
OpenAI behaviour
-
AI usage records
The actual OpenAI API key is configured in the server environment.
Pricing Rules
A singleton price-rule configuration controls pricing multipliers used by the estimate system.
Admin Reports
The project includes reports for:
-
Bookings
-
Revenue
-
Tattoo styles
-
Loyalty
-
Users
Reports Export
Supported:
JSON Lines (.jsonl)
Not implemented:
-
PDF reports
-
CSV reports
-
Excel
.xlsxreports
This distinction should be maintained in the published listing.
Client Registration
Clients can register with:
-
Name
-
Email
-
Mobile number
-
Password
-
Optional security question
-
Optional security answer
The documented minimum password length is 6 characters.
Passwords are securely stored using bcrypt hashing.
Client Login
The authentication flow includes:
-
Email and password login
-
JWT access token
-
JWT refresh token
-
Separate Admin authentication
-
Active/inactive account validation
-
Secure logout
-
Token refresh endpoint
Access token default lifetime:
15 minutes
Refresh token default lifetime:
7 days
Forgot Password
The project includes a security-question based password-reset workflow.
Process:
Enter Email
↓
Verify Security Answer
↓
Set New Password
The system does not depend on email OTP or SMS OTP for recovery.
Client Dashboard
The Client Dashboard includes:
-
Summary statistics
-
Recent activity
-
Quick navigation
-
Booking access
-
AI tools
-
Loyalty information
-
Notifications
-
Post-session functionality
Client Profile
Clients can:
-
View profile
-
Update name
-
Update mobile
-
Upload profile image
-
Change password
Tattoo Wishlist
Clients can add:
-
Tattoo designs
-
Tattoo artists
to their wishlist.
Features include:
-
Add wishlist item
-
View wishlist
-
Remove item
-
View enriched design/artist information
Tattoo Appointment Booking
Clients can create tattoo bookings with:
-
Artist
-
Tattoo design where applicable
-
Placement
-
Appointment slot
-
Pricing/estimate information
-
Tattoo concept reference
-
Up to 5 reference images
-
Optional AI concept
-
Optional flash claim
-
Optional touch-up parent booking
Appointment Slot Management
The booking system includes:
-
Artist/date slot lookup
-
Appointment slots
-
Availability validation
-
Availability blocks
-
Admin scheduling controls
This helps prevent bookings from functioning as simple uncontrolled appointment requests.
Booking Status Workflow
Supported statuses include:
-
Pending
-
Confirmed
-
ConsultationCompleted
-
Scheduled
-
InProgress
-
Completed
-
Rejected
-
Cancelled
Booking Management for Clients
Clients can:
-
Create booking
-
View booking list
-
Filter by status
-
Open booking details
-
View status timeline
-
Cancel eligible bookings
Clients cannot arbitrarily edit booking workflow states.
Tattoo Price Estimate
The public application includes a tattoo-pricing estimate endpoint.
Pricing can be influenced by studio configuration and Admin-managed price rules.
The project supports a configurable PriceRule model rather than relying entirely on fixed hard-coded values.
AI Tattoo Studio
The platform contains a dedicated AI Hub for tattoo-related tools.
The current documented tools include:
-
AI Tattoo Designer
-
Tattoo Meaning Generator
-
Tattoo Story Builder
-
Memory Mode
-
Couple Tattoo Matcher
-
Style Converter
-
Tattoo Transformation
-
Artist Match
-
AI Consultation Chat
AI Tattoo Designer
The AI Tattoo Designer allows users to enter tattoo-related concepts and receive AI-assisted design ideas.
It can be used as part of the ideation stage before a booking.
Generated concepts can optionally be saved to the user’s AI library.
AI Tattoo Meaning Generator
The platform contains a tool for generating possible symbolic meanings for tattoo concepts.
This can help clients understand or develop the theme behind their tattoo idea.
AI Tattoo Story Builder
The Story Builder creates a more narrative interpretation around a tattoo concept.
This can help users connect:
-
Symbols
-
Personal meaning
-
Theme
-
Memory
-
Story
Memory Mode
Memory Mode is designed for tattoo ideas inspired by personal memories or experiences.
The generated result can optionally be saved for later consultation or booking use.
Couple Tattoo Matcher
The Couple Matcher is an AI tool for generating or matching tattoo ideas intended for two people.
AI Tattoo Style Converter
The Style Converter accepts an image and assists with transforming the concept toward another tattoo style.
The uploaded image is handled through the platform’s AI workflow and local upload storage.
Tattoo Transformation Tool
The transformation tool can work with an uploaded tattoo/reference image for AI-assisted concept transformation.
This may support workflows such as redesign concepts depending on configured prompts and functionality.
AI Artist Match
The Artist Match tool helps suggest an artist based on the client’s tattoo requirement.
It does not create a separate artist account; artist data remains Admin-managed.
AI Tattoo Consultation Chat
The platform includes a stored consultation-chat workflow.
Users can:
-
Start consultation
-
Send messages
-
Receive AI responses
-
Continue prior conversation
-
Maintain consultation history
AI Saved Concepts
Users can save eligible AI outputs to their personal AI library.
A dedicated saved-items endpoint aggregates saved AI concepts.
AI Usage & Quota
The application includes:
-
AI status endpoint
-
Usage snapshot
-
Admin-defined quotas
-
AI configuration
-
AI request logs
-
Prompt settings
-
Feature flags
When OPENAI_API_KEY is missing, the project uses structured mock responses for supported AI tools.
Virtual Tattoo Try-On
The platform includes a virtual tattoo try-on tool.
The client can:
-
Upload a body photo
-
Place a tattoo design on the image
-
Move the design
-
Resize/reposition it
-
Preview the tattoo
-
Save preview
-
List saved previews
-
Delete preview
The frontend uses Konva / react-konva for this functionality.
Tattoo Builder
The Tattoo Builder provides a multi-step draft workflow.
Clients can:
-
Create tattoo draft
-
Save draft progress
-
Update draft
-
Complete builder
-
Feed builder information into a booking
Tattoo Placement Simulator
The project contains a body SVG placement simulator.
This is a client-side placement tool that helps users select or preview body-area placement.
It should be marketed as a placement simulator, not as full 3D augmented reality.
Flash Tattoo Drops
The public website includes active flash tattoo drops.
Clients can:
-
Browse current flash drops
-
Claim a drop
-
View own claims
Rules include:
-
One claim per user per drop
-
Sold-out protection
Tattoo Flash Claim to Booking
A flash claim can be connected to a later booking workflow where applicable.
This creates a useful link between limited tattoo designs and appointment operations.
Tattoo Passport
When a tattoo booking is completed, the system can automatically create a Tattoo Passport.
Clients can:
-
View passport list
-
Open passport details
-
View associated certificate information
Tattoo Certificate
Tattoo passport details can include certificate information connected to the completed session.
This gives the project a distinctive post-session feature beyond ordinary booking systems.
Healing Tracker
Clients can maintain a tattoo-healing journal after their session.
Features include:
-
Create healing entry
-
Link to booking
-
Upload up to 5 healing images per post
-
View healing entries
-
Use studio aftercare information
Admin can also view and update healing-related records.
Touch-Up Eligibility
The system can identify completed bookings eligible for tattoo touch-up.
The eligibility window is controlled through brand configuration such as:
touchUpEligibleDays
Showcase Submission
Clients can submit completed tattoo work to the studio showcase.
Submission includes:
-
Tattoo image
-
Caption
-
User association
Admin can:
-
Approve
-
Reject
-
Feature
Only approved showcase content appears publicly.
Tattoo Reviews
Users can review completed tattoo bookings.
Features include:
-
Create review
-
View own reviews
-
Edit rating
-
Edit review text
-
Admin moderation
-
Admin hide
-
Admin delete
Submitting a qualifying review can also award loyalty points.
Tattoo Loyalty Program
The project includes a dedicated loyalty system.
Clients can:
-
View loyalty transactions
-
View active rewards
-
Redeem reward
Admin can manage:
-
Loyalty rules
-
Rewards
-
Transactions
-
Manual point adjustments
Notifications
Clients can:
-
View personal notifications
-
View broadcast notifications
-
View unread count
-
Mark one read
-
Mark all read
Admin can:
-
Send notification to selected user
-
Broadcast notification
Tattoo Competition
The platform supports tattoo competitions.
Admin can:
-
Create competition
-
Edit competition
-
Delete competition
-
View vote counts
Logged-in users can vote.
Rule:
One vote per user per competition
Technology Used
| Layer | Technology |
|---|---|
| Frontend | React 19 |
| Language | TypeScript |
| Build Tool | Vite 8 |
| Routing | React Router 7 |
| Backend | Node.js |
| Framework | Express 4 |
| Database | MongoDB |
| ODM | Mongoose 8 |
| Authentication | JWT Access + Refresh |
| Password Security | bcrypt |
| Validation | express-validator, Zod |
| Forms | React Hook Form |
| Styling | Tailwind CSS 4 |
| UI | Radix UI |
| Icons | lucide-react |
| Server Data | TanStack React Query |
| HTTP Client | Axios |
| Uploads | Multer |
| AI | OpenAI SDK |
| Try-On | Konva / react-konva |
| Architecture | MERN Stack |
Step 1 — Open Project
cd "Smart AI Tattoo Studio Platform"
Step 2 — Install Dependencies
npm run install:all
Step 3 — Configure Environment
Server:
MONGODB_URI=mongodb://127.0.0.1:27017/tattoo_studio
JWT_ACCESS_SECRET=change-me-access-secret-min-32-chars
JWT_REFRESH_SECRET=change-me-refresh-secret-min-32-chars
OPENAI_API_KEY=
OPENAI_MODEL=gpt-4o-mini
CLIENT_URL=http://localhost:5173
PORT=5000
UPLOAD_MAX_MB=10
Client:
VITE_API_URL=http://localhost:5000/api/v1
If OPENAI_API_KEY is empty, AI features use the documented mock behaviour.
Step 4 — Start MongoDB
Ensure MongoDB is running at the configured MONGODB_URI.
Step 5 — Seed Data
npm run seed
For a refreshed demo catalog:
npm run seed:fresh
The fresh seed preserves the protected primary test Admin and User accounts.
Step 6 — Start Application
npm run dev
Development URLs:
Frontend: http://localhost:5173
API: http://localhost:5000/api/v1
README Included
Setup Support Available
Administrator
| Field | Value |
|---|---|
[email protected] |
|
| Password | Admin@123 |
User
| Field | Value |
|---|---|
[email protected] |
|
| Password | User@123 |