Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.jacobpevans.com/llms.txt

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

This guide walks you through everything you need to go from zero to a working local environment. You will clone the repository, install dependencies, apply any required configuration, and run the project. The steps below apply to most projects in this portfolio — check the repository’s own README.md for any project-specific differences.

Prerequisites

Before you begin, make sure you have the following installed on your machine:
  • Git — to clone the repository. Download Git
  • Node.js (v18 or later) or the runtime required by the specific project
  • A terminal and a code editor of your choice
If you are unsure which runtime a project requires, check the repository root for a .nvmrc, pyproject.toml, or similar version-lock file.

Set up the project

1

Clone the repository

Navigate to the directory where you want to store the project, then clone it from GitHub.
git clone https://github.com/JacobPEvans/<repository-name>.git
cd <repository-name>
Replace <repository-name> with the name of the specific project you want to set up.
2

Install dependencies

Install the project’s dependencies using the package manager specified in the repository. For most Node.js projects, run:
npm install
If the project uses a different package manager, the repository README.md will specify the correct command (for example, pip install -r requirements.txt for Python projects).
3

Configure your environment

Copy the example environment file and fill in any required values.
cp .env.example .env
Open .env in your editor and update any placeholders. Required variables are typically documented in the repository’s README.md or the Configuration guide.
Never commit your .env file to version control. The .gitignore in each project should already exclude it, but double-check before pushing.
4

Run the project

Start the project with the development command for the repository. For most projects, this is:
npm run dev
Once the process starts, the terminal will show the local URL or output location where you can interact with the project.

Next steps

Now that your environment is running, explore the rest of the documentation to go deeper:
  • Guides overview — practical walkthroughs for common tasks and workflows
  • Configuration — learn how to customize the project for your environment
  • FAQ — solutions to common setup and usage questions