|
1 | | -# Astro Starter Kit: Minimal |
| 1 | +# MAC Paving and Sealcoating - Official Website |
2 | 2 |
|
3 | | -```sh |
4 | | -npm create astro@latest -- --template minimal |
5 | | -``` |
| 3 | + |
| 4 | + |
| 5 | +Professional asphalt paving, sealcoating, concrete, and paver services across New Jersey. Built with Astro for optimal performance and SEO. |
| 6 | + |
| 7 | +## 🌐 Live Website |
| 8 | + |
| 9 | +**Production:** [https://macpavingandsealcoating.com](https://macpavingandsealcoating.com) |
| 10 | + |
| 11 | +## 🏗️ About the Project |
6 | 12 |
|
7 | | -[](https://stackblitz.com/github/withastro/astro/tree/latest/examples/minimal) |
8 | | -[](https://codesandbox.io/p/sandbox/github/withastro/astro/tree/latest/examples/minimal) |
9 | | -[](https://codespaces.new/withastro/astro?devcontainer_path=.devcontainer/minimal/devcontainer.json) |
| 13 | +This is the official website for MAC Paving and Sealcoating LLC, a New Jersey-based company specializing in: |
10 | 14 |
|
11 | | -> 🧑🚀 **Seasoned astronaut?** Delete this file. Have fun! |
| 15 | +- **Asphalt Paving** - Driveways, parking lots, resurfacing |
| 16 | +- **Sealcoating** - Protective coating and maintenance |
| 17 | +- **Concrete Work** - Sidewalks, curbs, aprons |
| 18 | +- **Paver Installation** - Decorative driveways and patios |
| 19 | +- **Landscaping** - Drainage solutions and outdoor improvements |
12 | 20 |
|
13 | | -## 🚀 Project Structure |
| 21 | +### 🎯 Key Features |
14 | 22 |
|
15 | | -Inside of your Astro project, you'll see the following folders and files: |
| 23 | +- **SEO Optimized** - Comprehensive meta tags, structured data, and sitemap |
| 24 | +- **Mobile Responsive** - Optimized for all devices |
| 25 | +- **Fast Performance** - Built with Astro for lightning-fast loading |
| 26 | +- **Service Area Coverage** - 60+ cities across North Jersey |
| 27 | +- **Contact Forms** - Multiple conversion-optimized contact forms |
| 28 | +- **Video Backgrounds** - Professional video content showcasing work quality |
| 29 | +- **Schema Markup** - Rich snippets for better search visibility |
| 30 | + |
| 31 | +## 🚀 Tech Stack |
| 32 | + |
| 33 | +- **Framework:** [Astro 5.10.0](https://astro.build) |
| 34 | +- **Language:** TypeScript |
| 35 | +- **Styling:** Custom CSS with Bootstrap grid |
| 36 | +- **Testing:** Vitest |
| 37 | +- **Linting:** ESLint with Astro plugin |
| 38 | +- **Build Tool:** Vite |
| 39 | + |
| 40 | +## 📁 Project Structure |
16 | 41 |
|
17 | 42 | ```text |
18 | 43 | / |
19 | | -├── public/ |
| 44 | +├── public/ # Static assets |
| 45 | +│ ├── assets/ |
| 46 | +│ │ ├── css/ # Stylesheets |
| 47 | +│ │ ├── js/ # JavaScript files |
| 48 | +│ │ ├── imgs/ # Images organized by sections |
| 49 | +│ │ └── fonts/ # Web fonts |
| 50 | +│ └── robots.txt |
20 | 51 | ├── src/ |
21 | | -│ └── pages/ |
22 | | -│ └── index.astro |
| 52 | +│ ├── assets/ # Processed assets |
| 53 | +│ ├── components/ # Reusable Astro components |
| 54 | +│ │ ├── About.astro |
| 55 | +│ │ ├── Footer.astro |
| 56 | +│ │ ├── Navbar.astro |
| 57 | +│ │ ├── LargeForm.astro |
| 58 | +│ │ ├── TestimonialsSlider.astro |
| 59 | +│ │ └── ... |
| 60 | +│ └── pages/ # Route-based pages |
| 61 | +│ ├── index.astro # Homepage |
| 62 | +│ ├── contact.astro # Contact page |
| 63 | +│ ├── services.astro # Services overview |
| 64 | +│ └── services/ # Individual service pages |
| 65 | +│ ├── asphalt-paving.astro |
| 66 | +│ ├── concrete.astro |
| 67 | +│ ├── landscaping.astro |
| 68 | +│ ├── pavers.astro |
| 69 | +│ └── sealer.astro |
| 70 | +├── tests/ # Test files |
| 71 | +├── astro.config.mjs # Astro configuration |
23 | 72 | └── package.json |
24 | 73 | ``` |
25 | 74 |
|
26 | | -Astro looks for `.astro` or `.md` files in the `src/pages/` directory. Each page is exposed as a route based on its file name. |
27 | | - |
28 | | -There's nothing special about `src/components/`, but that's where we like to put any Astro/React/Vue/Svelte/Preact components. |
29 | | - |
30 | | -Any static assets, like images, can be placed in the `public/` directory. |
| 75 | +## 🧞 Development Commands |
31 | 76 |
|
32 | | -## 🧞 Commands |
33 | | - |
34 | | -All commands are run from the root of the project, from a terminal: |
| 77 | +All commands are run from the root of the project: |
35 | 78 |
|
36 | 79 | | Command | Action | |
37 | 80 | | :------------------------ | :----------------------------------------------- | |
38 | | -| `npm install` | Installs dependencies | |
39 | | -| `npm run dev` | Starts local dev server at `localhost:4321` | |
40 | | -| `npm run build` | Build your production site to `./dist/` | |
41 | | -| `npm run preview` | Preview your build locally, before deploying | |
| 81 | +| `npm install` | Install dependencies | |
| 82 | +| `npm run dev` | Start dev server at `localhost:4321` | |
| 83 | +| `npm run build` | Build production site to `./dist/` | |
| 84 | +| `npm run preview` | Preview build locally before deploying | |
| 85 | +| `npm run lint` | Run ESLint on TypeScript, JavaScript, and Astro files | |
| 86 | +| `npm run test` | Run Vitest tests | |
42 | 87 | | `npm run astro ...` | Run CLI commands like `astro add`, `astro check` | |
43 | | -| `npm run astro -- --help` | Get help using the Astro CLI | |
44 | 88 |
|
45 | | -## 👀 Want to learn more? |
| 89 | +## 🛠️ Setup & Installation |
| 90 | + |
| 91 | +1. **Clone the repository** |
| 92 | + ```bash |
| 93 | + git clone [repository-url] |
| 94 | + cd astro-mac-repository |
| 95 | + ``` |
| 96 | + |
| 97 | +2. **Install dependencies** |
| 98 | + ```bash |
| 99 | + npm install |
| 100 | + ``` |
| 101 | + |
| 102 | +3. **Start development server** |
| 103 | + ```bash |
| 104 | + npm run dev |
| 105 | + ``` |
| 106 | + |
| 107 | +4. **Open browser** |
| 108 | + Navigate to `http://localhost:4321` |
| 109 | + |
| 110 | +## 🔧 Configuration |
| 111 | + |
| 112 | +### Astro Config (`astro.config.mjs`) |
| 113 | + |
| 114 | +- **Site URL:** `https://macpavingandsealcoating.com` |
| 115 | +- **Trailing Slash:** Always (prevents duplicate URLs) |
| 116 | +- **Sitemap:** Auto-generated with custom filtering |
| 117 | +- **Port:** 4321 with host access enabled |
| 118 | + |
| 119 | +### SEO Features |
| 120 | + |
| 121 | +- Comprehensive meta tags on all pages |
| 122 | +- Structured data (JSON-LD) for local business |
| 123 | +- Service area coverage (60+ NJ cities) |
| 124 | +- Canonical URLs for all pages |
| 125 | +- Open Graph and Twitter meta tags |
| 126 | + |
| 127 | +## 📱 Responsive Design |
| 128 | + |
| 129 | +The website is fully responsive with: |
| 130 | + |
| 131 | +- **Desktop:** Full-featured experience with video backgrounds |
| 132 | +- **Mobile:** Optimized layouts and touch-friendly navigation |
| 133 | +- **Tablet:** Adaptive grid systems and appropriate scaling |
| 134 | + |
| 135 | +## 🎨 Styling Architecture |
| 136 | + |
| 137 | +- **CSS Framework:** Custom CSS with Bootstrap grid system |
| 138 | +- **Animations:** AOS (Animate On Scroll) library |
| 139 | +- **Sliders:** Swiper.js for carousels |
| 140 | +- **Icons:** Custom icon font (Icomoon) |
| 141 | +- **Responsive Images:** Astro's optimized image processing |
| 142 | + |
| 143 | +## � Performance Features |
| 144 | + |
| 145 | +- **Image Optimization:** WebP format with fallbacks |
| 146 | +- **Code Splitting:** Automatic with Astro |
| 147 | +- **CSS/JS Minification:** Production builds |
| 148 | +- **Lazy Loading:** Images and components |
| 149 | +- **Preconnect:** External resources (fonts, CDNs) |
| 150 | + |
| 151 | +## 🧪 Testing |
| 152 | + |
| 153 | +- **Framework:** Vitest |
| 154 | +- **Test Files:** Located in `/tests/` directory |
| 155 | +- **Coverage:** Basic component and functionality tests |
| 156 | + |
| 157 | +## 📈 SEO & Analytics |
| 158 | + |
| 159 | +- **Local Business Schema:** Complete structured data |
| 160 | +- **Service Pages:** Individual pages for each service |
| 161 | +- **Area Coverage:** Dedicated content for service areas |
| 162 | +- **Contact Information:** Consistent NAP (Name, Address, Phone) |
| 163 | +- **Call-to-Action:** Strategic placement throughout site |
| 164 | + |
| 165 | +## 🚀 Deployment |
| 166 | + |
| 167 | +The site is configured for static site deployment and can be deployed to: |
| 168 | + |
| 169 | +- **Netlify** (recommended for Astro) |
| 170 | +- **Vercel** |
| 171 | +- **GitHub Pages** |
| 172 | +- **Traditional web hosting** |
| 173 | + |
| 174 | +Build command: `npm run build` |
| 175 | +Output directory: `dist/` |
| 176 | + |
| 177 | +## 📞 Contact Information |
| 178 | + |
| 179 | +**MAC Paving and Sealcoating LLC** |
| 180 | +- **Phone:** (201) 755-7836 |
| 181 | +- **Website:** [macpavingandsealcoating.com](https://macpavingandsealcoating.com) |
| 182 | +- **Service Area:** Northern New Jersey |
| 183 | + |
| 184 | +## 📄 License |
| 185 | + |
| 186 | +© 2025 MAC Paving and Sealcoating LLC. All rights reserved. |
| 187 | + |
| 188 | +--- |
46 | 189 |
|
47 | | -Feel free to check [our documentation](https://docs.astro.build) or jump into our [Discord server](https://astro.build/chat). |
| 190 | +For technical support or development questions, please refer to the [Astro documentation](https://docs.astro.build) or contact the development team. |
0 commit comments