Documentation
E-shop Launch Guide
Complete guide to getting your e-shop up and running. No coding required — follow this guide step by step.
Estimated time: 1-2 hours
Most of the time is spent creating accounts with services. The actual deployment takes just minutes.
Table of Contents
Claude Code will help you
If you run into any issues, launch Claude Code in the terminal with the command claude and describe what's happening. The AI assistant will help you solve the problem.
What you'll need
Basic things you'll need to launch your e-shop:
Basic requirements
Computer
Windows, Mac, or Linux — anything works
Email address
For registering with services (Vercel, Stripe...)
What you'll receive after purchase
ZIP file with project folder
Contains the complete e-shop source code that you extract and can start customizing
Payment card (for Stripe verification)
Stripe requires card verification during registration. Nothing will be charged — it's just for identity verification.
No special skills required
Glossary of terms
Before you start, it's helpful to understand what the various tools and services do. Here's a brief overview:
Programs on your computer
Claude Code
Your AI assistant. Runs in the terminal and helps you with anything — setup, modifications, fixes. Just tell it what you need and it does it for you.
Terminal
A command window for entering commands. On Windows it's "Command Prompt" (cmd), on Mac it's "Terminal". You'll only use it to launch Claude Code.
Node.js
A program that allows the e-shop to run on your computer. Install it once and then you can forget about it.
VS Code(optional)
A file editor for browsing files. Not required — Claude Code handles everything on its own. Useful if you want to see the project structure.
Online services
Vercel
Hosting — where your e-shop runs on the internet. Free for small projects. Handles speed and availability 24/7.
GitHub(optional)
Storage for your code. Like Dropbox, but for developers. Not required, but makes connecting with Vercel easier.
Neon
Database — where products, orders, and customers are stored. The free tier is more than enough.
Stripe
Payment gateway — processes card payments, Apple Pay, Google Pay. You only pay a commission on transactions.
Resend
Email sending service for customers — order confirmations, shipping notifications. 3,000 emails per month free.
Don't worry
Installing Node.js
Why manual installation? Node.js runs in the background and enables the e-shop to function. You only need to install it once — all further commands will be run by Claude Code for you.
- 1
Go to nodejs.org
- 2
Click the "Get Node.js®"
- 3
On the Download page, select the LTS version (recommended, currently v24)
The page automatically detects your system and offers the correct file
- 4
Open the downloaded file → click "Next" until the end
- 5
Restart your computer
Claude Code registration
Claude Code is an AI assistant that will help you with all e-shop setup.
ACreating an Anthropic account
- 1
Go to console.anthropic.com
- 2
Click "Sign Up" and create an account (you can use a Google account)
- 3
Choose a plan — we recommend Claude Pro ($20/month)
Recommended plans:
- Claude Pro — $20/month — ideal for most users
- Claude Max — $100/month — for intensive use
A subscription is significantly cheaper than paying via API credits.
BInstalling Claude Code
- 1
Open a terminal:
- Windows: Win + R, type
cmd, Enter - Mac: Cmd + Space, type "Terminal", Enter
- Windows: Win + R, type
- 2
Copy this command into the terminal and press Enter:
npm install -g @anthropic-ai/claude-code - 3
Wait for the installation to complete (may take a minute)
CFirst launch and login
- 1
In the terminal, type:
claude - 2
On first launch, a browser will open for logging into your Anthropic account
- 3
Log in and grant access
- 4
Claude Code is ready! From now on, you can communicate with it directly in the terminal
Ready!
Creating service accounts
The e-shop uses several free services. Create an account with each one.
Vercel
Hosting — where your e-shop will run
- 1
Go to vercel.com
- 2
Click "Sign Up" and register (we recommend using GitHub or email)
- 3
Confirm your email if required
Neon
Database — where products and orders are stored
- 1
Go to neon.tech
- 2
Click "Sign Up" and register
- 3
After logging in, click "New Project"
- 4
Name the project (e.g. "my-eshop") and select region eu-central-1 (Frankfurt)
After creation, copy the Connection string — save it!
Stripe
Payments — processing card payments
- 1
Go to stripe.com
- 2
Click "Start now" and create an account
- 3
Complete the business verification process (you can finish later)
- 4
In the Dashboard: Developers → API keys — copy both keys
Resend
Emails — sending emails to customers
- 1
Go to resend.com
- 2
Register and log in
- 3
Go to API Keys and create a new key — save it!
Summary — you should have:
- ✓ Vercel account
- ✓ Neon Connection string (database)
- ✓ Stripe Publishable key and Secret key
- ✓ Resend API key
Project setup
Now we'll set up the e-shop on your computer.
Extract the project
Extract the ZIP file and move the folder where you want (e.g. to the Desktop)
Open a terminal in the folder
Windows: Open folder → right-click → "Open in Terminal"
Mac: Right-click on folder → "New Terminal at Folder"
Launch Claude Code
Tell Claude Code what you need
Claude Code will do everything for you — configure settings, install dependencies, start the e-shop.
"Set up the e-shop with these details:
- - Neon database: [your connection string]
- - Stripe publishable key: [key]
- - Stripe secret key: [key]
- - Resend API key: [key]
Then start the e-shop locally."
Claude Code will automatically create the configuration, install everything needed, and start the e-shop on localhost:3000
Local development vs. production
You can run the e-shop in two ways.
Local development
On your computer
Only you can see the e-shop. For testing and modifications.
- •Testing new features
- •Design and content changes
- •Experimenting without risk
Address:
http://localhost:3000Production
On the internet (Vercel)
Everyone on the internet can see the e-shop. For live operation.
- •Live e-shop operation
- •Receiving orders
- •Real payments and deliveries
Address:
https://vas-eshop.vercel.appBasic terminal commands
These are the commands you'll use most often.
npm installonce at the startInstalls all required libraries.
npm run devlocal developmentStarts the e-shop on localhost:3000
npm run buildbefore deploymentPrepares the e-shop for production.
git add . && git commit -m "popis" && git pushdeploying changesUploads changes to GitHub → Vercel deploys automatically.
npx prisma db pushdatabaseUpdates the database structure.
claudeAI assistantLaunches Claude Code — then tell it what you need.
Recommended workflow
npm run dev) → 2. Test → 3. npm run build → 4. git pushDeploying to the internet
Now we'll upload the e-shop to Vercel so it's accessible on the internet.
Option A: Via GitHub (recommended)
- 1
Tell Claude Code:
"Create a new GitHub repository and upload this project there"
- 2
In the Vercel dashboard, click "Add New Project"
- 3
Connect your GitHub account and select the repository
- 4
In the "Environment Variables" section, add all variables from
.env - 5
Click "Deploy" and wait
Option B: Via Vercel CLI
- 1
Install Vercel CLI:
npm install -g vercel - 2
Run the deployment:
vercel - 3
Answer the questions (usually just press Enter)
- 4
After deployment, add environment variables in the Vercel dashboard
Done!
vas-projekt.vercel.appSetting up payments (Stripe)
For payments to work, you need to set up a webhook in Stripe.
- 1
In the Stripe dashboard: Developers → Webhooks
- 2
Click "Add endpoint"
- 3
Enter the Endpoint URL:
https://vase-domena.cz/api/stripe/webhookReplace the domain with your actual domain or Vercel URL
- 4
Select events:
- • payment_intent.succeeded
- • payment_intent.payment_failed
- • payment_intent.processing
- • checkout.session.completed
- • charge.succeeded
- • charge.updated
- 5
Click "Add endpoint"
- 6
Copy the Signing secret (whsec_...) → add it to Vercel as
STRIPE_WEBHOOK_SECRET
Adding a custom domain
If you want to use a custom domain instead of the vercel.app address.
- 1
Buy a domain from a registrar (Namecheap, GoDaddy, IONOS...)
- 2
In the Vercel dashboard: Settings → Domains
- 3
Add your domain
- 4
Vercel will show you DNS records to configure at your registrar
- 5
Wait for DNS propagation (usually minutes, max 24 hours)
First steps after launch
The e-shop is running! You can perform all steps using Claude Code.
Change admin password (important!)
The default login credentials are publicly known. It's important to change them immediately.
Tell Claude Code:
"Change the admin password to [your new password]"
Set up store info
"Change the e-shop name to [name] and set the contact email to [email]"
Customize the design
"Change the primary color of the e-shop to blue"
Add products
"Add a new category Clothing" or "Add a product T-Shirt for $19.99"
Set up shipping
"Set the shipping cost for Standard to $9.99"
Set up emails
"Change the sender email to info@my-eshop.com"
Test an order
"Help me test the entire order process"
Remember
Need help?
If you're unsure, Claude Code will help you. Alternatively, contact me by email.