Homepage
Explains the Written Worlds brand, promotes services, and links visitors to services, pricing, books, and contact.
Internal Owner Reference
Written Worlds owner guide.
This page is not a customer-facing sales page. It is a practical owner reference for current features, setup, order handling, and testing.
Internal note: This page is de-emphasized in public navigation and marked noindex. Keep private credentials out of this page.
Current website
Features that are live or prepared now
Services
Lists the main writing, author support, and website-service categories. Each category has its own detail page.
Pricing
Shows fiction-writing prices by length and genre, including the $99 novella offer and higher-scope manuscript options.
Books
Shows the Paradise collection with Amazon ASIN-backed Kindle buy links, ASIN display, and individual detail pages.
Contact form
Collects customer inquiries and sends them to written.worlds.exist@gmail.com.
Amazon checkout model
Explains that book purchases route to Amazon checkout instead of a direct Written Worlds cart.
Stripe service checkout
Eligible fixed-scope Story Builder services can create a Stripe Checkout session when Stripe environment variables are configured.
Order confirmation flow
Paid Stripe service orders generate a WW-YYYY-###### order number, admin email, customer email, success page, and paid Project Blueprint PDF.
Dashboards
Provides customer, author, and administrator dashboard previews for the future account system.
Legal policies
Provides active terms, privacy, refund, author terms, and marketplace disclaimer pages while future systems still require additional review.
Owner setup
Items to protect or finish manually
Vercel environment variables
These must stay set in the Vercel project: RESEND_API_KEY, CONTACT_FROM_EMAIL, CONTACT_TO_EMAIL, STRIPE_SECRET_KEY, and STRIPE_WEBHOOK_SECRET.
Resend account
This sends contact form emails and order emails. Keep the API key private and do not paste it into public chats or documents.
Stripe account
Use Stripe Dashboard to confirm paid service orders, locate the Stripe Checkout Session ID, and issue refunds if needed.
Manual order tracker
Until a permanent database exists, record each paid order from the admin email into a manual tracker using the order number and Stripe Session ID.
Domain DNS
writtenworlds.net should point to Vercel. Email-related DNS records from Resend or Gmail should not be deleted.
Book author name
Confirm the public author or pen name that should replace Written Worlds Studio if needed.
Book descriptions
Replace temporary catalog descriptions with final owner-approved descriptions for each Paradise title.
Book graphics
Add cover images and specialized graphics when files or approved AI graphics are available.
Amazon paperback links
Provide paperback URLs later if paperback editions are published through Amazon KDP.
Legal review
Draft terms, refund, privacy, author, commission, and marketplace policy pages should be reviewed before launch.
Order operations
Paid order handling
- Open the New paid Written Worlds order email.
- Copy the WW-YYYY-###### order number.
- Open the Stripe dashboard search link from the admin email.
- Confirm the payment status is paid.
- Compare customer email, amount paid, discount code, and selected services.
- Add the order to the manual order tracker.
- Contact the customer with the order number and any material requests.
Current limitation: no permanent Written Worlds order database exists yet. Stripe metadata, Stripe records, and email confirmations are the current order record.
Testing
Simple test checklist
- Open the homepage and confirm the main buttons work.
- Open /services and click several View Service buttons.
- Open /pricing and confirm the prices and service names look right.
- Open /books and confirm the Paradise Amazon catalog appears.
- Confirm each book title starts with Paradise:
- Confirm each book card shows an ASIN and Available on Amazon status.
- Click a Buy on Amazon button and confirm it opens Amazon in a new tab.
- Open /checkout and confirm it describes Amazon checkout links.
- Open /payments and confirm Stripe/PayPal are described as optional service-payment tools.
- Open /contact and submit a test inquiry.
- Confirm the test inquiry arrives at written.worlds.exist@gmail.com.
- For Stripe test mode, complete a test service checkout and confirm the admin email, customer email, success page, and Project Blueprint PDF are created.
Private settings
Environment variables
These are private values stored in Vercel, not in the public website code.
- RESEND_API_KEY sends email through Resend.
- CONTACT_FROM_EMAIL controls the sender address.
- CONTACT_TO_EMAIL controls the owner inbox.
- STRIPE_SECRET_KEY creates and verifies Stripe Checkout sessions.
- STRIPE_WEBHOOK_SECRET verifies Stripe checkout completion webhooks.
Future build plan
What comes later
Order database
Replace the current Stripe metadata and email-only record model with secure database storage and owner dashboard access.
Book polish
Add final descriptions, cover images, author pages, publication dates, categories, and paperback links if available.
Specialized graphics
Keep branded homepage visuals, service icons, marketplace imagery, and social sharing images updated as artwork is approved.
Service payments
Expand Stripe and/or PayPal only if direct payments for more services are approved later.
Authentication and database
Turn dashboard previews into real account areas with saved orders, messages, listings, and admin controls.
Newsletter
Connect a real newsletter provider and consent process.