Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/apursley2012/fortune-seeker/llms.txt

Use this file to discover all available pages before exploring further.

Fortune Seeker is an open-source portfolio template that turns your developer story into an interactive divination experience. Built with React, Framer Motion, and Tailwind CSS, it features flipping tarot cards, a glowing custom cursor, sigil animations, and a deep obsidian-and-gold aesthetic — all deployable to GitHub Pages with a single build command.

Quickstart

Clone the repo, install dependencies, and launch your mystical portfolio in minutes.

Project Structure

Understand how pages, components, and assets are organized before you customize.

Customization

Swap colors, fonts, and content to make the template uniquely yours.

Components

Explore every animated UI component — TarotCard, CrystalBall, Starfield, and more.

What’s Inside

Fortune Seeker ships with nine fully-built pages wired up through React Router v6, each themed around a divination concept:
PageRouteTheme
Home/”Seek Your Fortune” — card reveal entry
About/about”The Reader” — three-card timeline spread
Projects/projects”Major Arcana” — flipping project cards
Skills/skills”Cast Spells” — SVG sigil draw animations
Work History/work”The Pendulum Swing” — scroll-linked pendulum
Case Studies/case-studies”The Deep Reading” — card-gated long-form
Blog/blog”The Scribe’s Pages” — aged paper posts
Testimonials/testimonials”Channeled Reviews” — atmospheric fade cycle
Contact/contact”Send a Sigil” — ritual form submission

Getting Started

1

Clone the repository

git clone https://github.com/apursley2012/fortune-seeker.git
cd fortune-seeker
2

Install dependencies

npm install
3

Start the dev server

npm run dev
Open http://localhost:5173 to see your portfolio.
4

Personalize your content

Edit the page source files in assets/main.js (or the pre-built component files) to add your own projects, skills, and bio. See the Content Customization guide for details.

Key Features

Tarot Card Animations

3D flip animations powered by Framer Motion with spring physics and shimmer effects.

Mystical UI Components

Crystal ball, candle flame, starfield, and custom cursor — all composable React components.

Atmospheric Dark Theme

Gold-on-obsidian palette with Cormorant Garamond serif headings and radial gradient glows.

GitHub Pages Ready

Static Vite build deploys directly to GitHub Pages with zero server configuration.

Build docs developers (and LLMs) love