Skip to content

Commit

Permalink
Merge pull request #21 from dylanson25/develop
Browse files Browse the repository at this point in the history
Update Main respect develop
  • Loading branch information
dylanson25 authored Oct 3, 2024
2 parents d7abe26 + 54fb8b0 commit 212155d
Showing 1 changed file with 78 additions and 38 deletions.
116 changes: 78 additions & 38 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,54 +1,94 @@
# Astro Starter Kit: Basics
# Dylanson25 Portfolio

```sh
npm create astro@latest -- --template basics
```
Welcome to the official repository for my personal portfolio! This project showcases my skills, projects, and experience in web development using modern technologies like **AstroJS**, **TailwindCSS**, and **Netlify**.

## Table of Contents

* [Project Overview](#project-overview)
* [Technologies](#technologies)
* [Setup and Installation](#setup-and-installation)
* [Usage](#usage)
* [Continuous Integration (CI)](#continuous-integration-ci)
* [Deployment](#deployment)
* [Contributing](#contributing)
* [License](#license)

## Project Overview

This portfolio website is built to present my work, skills, and development journey. It is optimized for performance, scalability, and cross-browser compatibility. The website is live and continuously deployed on **Netlify**.

## Technologies

[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/basics)
[![Open with CodeSandbox](https://assets.codesandbox.io/github/button-edit-lime.svg)](https://codesandbox.io/p/sandbox/github/withastro/astro/tree/latest/examples/basics)
[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/withastro/astro?devcontainer_path=.devcontainer/basics/devcontainer.json)
This project uses the following technologies:

> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
* **[AstroJS](https://astro.build/)**: A modern static site builder for faster web development.
* **[TailwindCSS](https://tailwindcss.com/)**: A utility-first CSS framework for styling.
* **[Netlify](https://www.netlify.com/)**: Deployment and hosting of the website.
* **ESLint**: For maintaining code quality and adhering to best practices.
* **Prettier**: Code formatting to keep consistency across the project.

![just-the-basics](https://github.com/withastro/astro/assets/2244813/a0a5533c-a856-4198-8470-2d67b1d7c554)
## Setup and Installation

## 🚀 Project Structure
To set up the project locally, follow these steps:

Inside of your Astro project, you'll see the following folders and files:
1. **Clone the repository:**

```text
/
├── public/
│ └── favicon.svg
├── src/
│ ├── components/
│ │ └── Card.astro
│ ├── layouts/
│ │ └── Layout.astro
│ └── pages/
│ └── index.astro
└── package.json
```bash
git clone https://github.com/dylanson25/your-repo-name.git
cd your-repo-name
```

Astro looks for `.astro` or `.md` files in the `src/pages/` directory. Each page is exposed as a route based on its file name.
2. **Install dependencies:**

There's nothing special about `src/components/`, but that's where we like to put any Astro/React/Vue/Svelte/Preact components.
Ensure you have [Node.js](https://nodejs.org/) installed, then run:

```bash
npm install
```

3. **Start the development server:**

```bash
npm run dev
```

Any static assets, like images, can be placed in the `public/` directory.
This will start the AstroJS development server, and you can view the project locally.

## 🧞 Commands
## Usage

The primary commands to run and build the project are:

* `npm run dev`: Starts the development server.
* `npm run build`: Builds the project for production.
* `npm run preview`: Previews the production build locally.
* `npm run lint`: Runs ESLint to check for any code quality issues.
* `npm run format`: Runs Prettier to automatically format code.

## Continuous Integration (CI)

GitHub Actions are configured for this project to ensure consistent quality in every pull request:

* **Linting CI**: Automatically checks the code quality using ESLint.
* **Stylelint CI**: Ensures consistent styling of CSS and Astro files.

## Deployment

The project is deployed automatically on **Netlify** after each push or pull request. You can view the live version at: <https://dylanson25.dev>

To deploy manually, run:

```bash
npm run build
```

All commands are run from the root of the project, from a terminal:
Then deploy the contents of the `dist/` directory to Netlify or your preferred hosting platform.

| Command | Action |
| :------------------------ | :----------------------------------------------- |
| `npm install` | Installs dependencies |
| `npm run dev` | Starts local dev server at `localhost:4321` |
| `npm run build` | Build your production site to `./dist/` |
| `npm run preview` | Preview your build locally, before deploying |
| `npm run astro ...` | Run CLI commands like `astro add`, `astro check` |
| `npm run astro -- --help` | Get help using the Astro CLI |
## Contributing

## 👀 Want to learn more?
Contributions are welcome! If you have suggestions for improvements or find bugs, feel free to create a pull request or open an issue.

Feel free to check [our documentation](https://docs.astro.build) or jump into our [Discord server](https://astro.build/chat).
1. Fork the repository.
2. Create a new branch (`git checkout -b feature-branch`).
3. Commit your changes (`git commit -m 'Add some feature'`).
4. Push to the branch (`git push origin feature-branch`).
5. Open a pull request.

0 comments on commit 212155d

Please sign in to comment.