Skip to content

Commit e2eddab

Browse files
CodeMeAPixelCodeMeAPixel
authored
Development (#5)
* feat(add): blog setup * feat(add): blog page(s), skills page and other improvements * feat(add): about and contact pages * feat(add): ton of new features and changes * add(pixie): graphics * feat(add): fix missing blog client......... * feat(add): updated layouts and more * updated: README * add: license * rem: vercel badge * update: readme again
1 parent 6709548 commit e2eddab

File tree

187 files changed

+16463
-658
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

187 files changed

+16463
-658
lines changed

‎LICENSE‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
Copyright 2025 ByteBrush Studios
2+
3+
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
4+
5+
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
6+
7+
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

‎README.md‎

Lines changed: 178 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,94 @@
1-
This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
1+
# CodeMeAPixel Portfolio
22

3-
## Getting Started
3+
[![Next.js](https://img.shields.io/badge/Next.js-15.3.0-black?logo=next.js&style=flat-square)](https://nextjs.org/)
4+
[![React](https://img.shields.io/badge/React-19.0.0-61DAFB?logo=react&style=flat-square&logoColor=white)](https://react.dev/)
5+
[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?logo=typescript&style=flat-square&logoColor=white)](https://www.typescriptlang.org/)
6+
[![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-3.4.17-38bdf8?logo=tailwindcss&style=flat-square&logoColor=white)](https://tailwindcss.com/)
7+
[![Framer Motion](https://img.shields.io/badge/Framer_Motion-11.15.0-0055FF?logo=framer&style=flat-square&logoColor=white)](https://www.framer.com/motion/)
8+
[![License: MIT](https://img.shields.io/github/license/CodeMeAPixel/portfolio?style=flat-square)](LICENSE)
9+
[![Open in GitHub Codespaces](https://img.shields.io/badge/Codespaces-Open%20in%20GitHub-181717?logo=github&style=flat-square)](https://github.com/codemeapixel/portfolio/codespaces)
410

5-
First, run the development server:
11+
> **A modern, full-stack developer portfolio built with Next.js 15, React 19, TypeScript, and Tailwind CSS. Optimized for performance, accessibility, and exceptional developer experience.**
12+
13+
---
14+
15+
## 🚀 Features
16+
17+
- **Next.js 15+**: App Router, SSR, SSG, ISR, API routes, and Turbopack acceleration.
18+
- **React 19**: Utilizing the latest React version with improved performance.
19+
- **TypeScript**: End-to-end type safety with full TypeScript integration.
20+
- **Tailwind CSS**: Utility-first, responsive design with multiple theme support.
21+
- **MDX Blog**: Write posts with Markdown + JSX featuring syntax highlighting (via Shiki/Rehype Pretty Code), line numbers, and custom components.
22+
- **Dynamic Projects & Referrals**: Modular TypeScript data files for easy content management.
23+
- **Animated UI**: Powered by Framer Motion v11, custom CSS animations, and engaging pixel/glitch effects.
24+
- **Theme System**: Multiple color themes (blue, purple, teal, rose, amber) with instant switching and local storage persistence.
25+
- **Responsive Design**: Mobile-first approach with optimized layouts for all devices.
26+
- **Accessibility**: WCAG-compliant with keyboard navigation, semantic HTML, and proper contrast ratios.
27+
- **Playlist & Music Player**: Custom React audio implementation with playlists and pagination.
28+
- **Social Integration**: Configurable link hub with tooltips powered by Radix UI.
29+
- **Advanced SEO**: Comprehensive metadata, Open Graph tags, and Twitter cards for maximum discoverability.
30+
- **Vercel Optimized**: Ready for edge deployment with Vercel's platform features.
31+
- **Developer Experience**: ESLint configuration, TypeScript strict mode, and organized project structure.
32+
33+
---
34+
35+
## 🛠️ Tech Stack
36+
37+
| Tool | Version | Description |
38+
|-----------------------|------------|--------------------------------------------------------------|
39+
| [Next.js] | 15.3.0 | React framework with App Router, SSR, and edge capabilities |
40+
| [React] | 19.0.0 | UI library with the latest improvements and concurrent features |
41+
| [TypeScript] | 5.x | Static typing for safer, more maintainable code |
42+
| [Tailwind CSS] | 3.4.17 | Utility-first CSS framework with theming support |
43+
| [Framer Motion] | 11.15.0 | Production-ready motion library for React |
44+
| [MDX] | 5.0.0 | Markdown + JSX for rich content authoring |
45+
| [Radix UI] | 1.x-2.x | Unstyled, accessible UI primitives for custom components |
46+
| [React Icons] | 5.5.0 | Comprehensive icon library with consistent design |
47+
| [Rehype Pretty Code] | 0.14.0 | Syntax highlighting with themes and line highlighting |
48+
| [Shiki] | 3.2.1 | TextMate grammar-based syntax highlighter |
49+
| [Tailwind Merge] | 2.6.0 | Utility for merging Tailwind CSS classes |
50+
| [date-fns] | 4.1.0 | Modern JavaScript date utility library |
51+
| [clsx] | 2.1.1 | Tiny utility for constructing className strings conditionally |
52+
| [Turbopack] | Built-in | Incremental bundler for faster builds and refreshes |
53+
54+
---
55+
56+
## 📦 Project Structure
57+
58+
<details>
59+
<summary><strong>Click to expand</strong></summary>
60+
61+
```
62+
src/
63+
app/ # Next.js app directory (routes, pages, layouts)
64+
components/ # Reusable UI components (layouts, static, ui, etc.)
65+
lib/ # Data, API clients, and utility functions
66+
links/ # Link hub, playlists, categories, etc.
67+
projects/ # Project data and logic
68+
posts/ # Blog posts in MDX format
69+
styles/ # Tailwind and global CSS
70+
types/ # TypeScript types and interfaces
71+
public/ # Static assets (images, covers, previews)
72+
```
73+
</details>
74+
75+
---
76+
77+
## 📝 Usage
78+
79+
### 1. **Install dependencies**
80+
81+
```bash
82+
npm install
83+
# or
84+
yarn install
85+
# or
86+
pnpm install
87+
# or
88+
bun install
89+
```
90+
91+
### 2. **Run the development server**
692

793
```bash
894
npm run dev
@@ -14,23 +100,101 @@ pnpm dev
14100
bun dev
15101
```
16102

17-
Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
103+
Open [http://localhost:3000](http://localhost:3000) to view the site.
104+
105+
### 3. **Build for production**
106+
107+
```bash
108+
npm run build
109+
npm start
110+
```
111+
112+
---
113+
114+
## ✍️ Adding Content
115+
116+
### Blog Posts
117+
118+
- Add `.mdx` files to `src/posts/`.
119+
- Use frontmatter for metadata:
120+
```md
121+
---
122+
title: 'My Post'
123+
date: '2025-03-01'
124+
description: 'A short summary.'
125+
tags: ['Next.js', 'React']
126+
---
127+
```
128+
129+
### Projects
130+
131+
- Add or edit files in `src/lib/projects/data/`.
132+
- Use the `Project` type for structure and documentation.
133+
134+
### Referrals
135+
136+
- Add or edit files in `src/lib/referrals/data/`.
137+
- Use the `Referral` and `ReferralCategory` types.
138+
139+
---
140+
141+
## 🎨 Theming
142+
143+
- Supports multiple color themes (blue, purple, teal, rose, amber, etc.).
144+
- Theme is persisted and can be changed via the UI.
145+
146+
---
147+
148+
## 🎵 Playlist & Music Player
149+
150+
- Curated playlists in `src/lib/links/data/playlist/`.
151+
- Custom React music player with pagination and genre filtering.
152+
153+
---
154+
155+
## 🧩 Customization
156+
157+
- **Navigation:** Edit `src/components/static/Navbar.tsx` for links and icons.
158+
- **Social Links:** Configure in `src/lib/links/data/`.
159+
- **Animations:** Customize in `src/styles/globals.css` and Framer Motion props.
160+
161+
---
162+
163+
## 🛡️ Accessibility & SEO
164+
165+
- Keyboard navigable, focus-visible, and color contrast checked.
166+
- SEO meta tags and Open Graph support for rich sharing.
167+
168+
---
169+
170+
## 📄 License
171+
172+
This project is [MIT licensed](LICENSE).
18173

19-
You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
174+
---
20175

21-
This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
176+
## 🙋‍♂️ Author
22177

23-
## Learn More
178+
**CodeMeAPixel**
179+
[Portfolio](https://codemeapixel.dev) • [GitHub](https://github.com/CodeMeAPixel) • [Twitter](https://twitter.com/CodeMeAPixel)
24180

25-
To learn more about Next.js, take a look at the following resources:
181+
---
26182

27-
- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
28-
- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
183+
## ⭐️ Show your support
29184

30-
You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
185+
If you like this project, please consider starring the repo and sharing it!
31186

32-
## Deploy on Vercel
187+
[![Star on GitHub](https://img.shields.io/github/stars/CodeMeAPixel/portfolio?style=social)](https://github.com/CodeMeAPixel/portfolio)
33188

34-
The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
189+
---
35190

36-
Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.
191+
[Next.js]: https://nextjs.org/
192+
[React]: https://react.dev/
193+
[TypeScript]: https://www.typescriptlang.org/
194+
[Tailwind CSS]: https://tailwindcss.com/
195+
[Framer Motion]: https://www.framer.com/motion/
196+
[MDX]: https://mdxjs.com/
197+
[Radix UI]: https://www.radix-ui.com/
198+
[PrismJS]: https://prismjs.com/
199+
[React Icons]: https://react-icons.github.io/react-icons/
200+
[Vercel]: https://vercel.com/

0 commit comments

Comments
 (0)