Getting Fortune Seeker running locally takes just a few commands. The project is a standard Vite + React application, so the workflow will feel familiar if you have worked with any modern React starter before. Once you have the dev server running, you can explore all nine pages, inspect the component animations, and begin swapping in your own 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.
Prerequisites
- Node.js 18 or later — Vite requires Node 18+. Run
node -vto confirm your version. - Git — needed to clone the repository.
Steps
Clone or fork the repository
Clone the Fortune Seeker repository to your local machine:If you plan to deploy your own version to GitHub Pages, fork the repository first so you have your own remote to push to.
Install dependencies
Install all project dependencies with npm:This pulls in React, React Router v6, Framer Motion, Tailwind CSS, Lucide React, and the Vite build toolchain.
Start the development server
Launch Vite’s dev server with hot module replacement:The terminal will confirm the local address. Open your browser to:You should see the Fortune Seeker homepage with the animated starfield background and the central “The Developer” tarot card.
Explore the nine pages
Click the tarot card on the homepage to fan out the navigation links, then explore every route:
| Route | Thematic Name | Description |
|---|---|---|
/ | Seek Your Fortune | Animated homepage with interactive tarot card |
/about | The Reader | Three-card spread bio with CrystalBall component |
/projects | Drawn Cards | Flipping project cards revealing tech stack details |
/skills | Cast Spells | SVG sigil animations for each technology |
/work | The Pendulum Swing | Scroll-driven pendulum work history timeline |
/case-studies | The Deep Reading | Detailed case study cards with expand animation |
/blog | The Scribe’s Pages | Parchment-styled article listing |
/testimonials | Channeled Reviews | Auto-rotating testimonial display |
/contact | Send a Sigil | Contact form with pentagram casting animation |
Customize your content
Once you are familiar with the layout, update the placeholder text, project data, and personal details with your own information. See the content customisation guide for a full walkthrough of every editable section.
Available Scripts
| Command | Description |
|---|---|
npm run dev | Starts the Vite development server at http://localhost:5173 with hot module replacement |
npm run build | Compiles and bundles the app into the dist/ folder for production deployment |
npm run preview | Serves the production build locally so you can verify the output before deploying |