Skip to content

aolingge/open-source-portfolio

Open Source Portfolio

Languages: English | 简体中文

A deployment-first bilingual portfolio and lightweight service landing page for students, independent developers, and new open source maintainers.

It is built with React, TypeScript, and Vite, with GitHub Pages deployment already wired in. The default content is tuned for Aolingge's public work: practical projects, deployment ability, contribution readiness, release proof, and a clear service offer.

Why This Exists

Most portfolio templates focus on decoration. This one focuses on proof:

  • selected projects with real engineering context
  • bilingual English / Chinese content with live language switching
  • a focused services section with concrete packages
  • readable source code for fast customization
  • GitHub Pages workflow included
  • open source docs that make forks and pull requests easy

Quick Start

npm install
npm run dev

Build the production site:

npm run build

Preview the production build:

npm run preview

Customize

Edit the profile, locale, and project content in src/App.tsx.

Important fields:

  • meta: page title and description for both languages
  • profile: name, role, headline, email, GitHub link, audit service link
  • offers: service packages, scope, and links
  • projects: project title, category, summary, stack, main link, and proof link
  • process: the operating loop shown near the bottom of the page

Visual styling lives in src/App.css and global theme variables live in src/index.css.

Deploy To GitHub Pages

The workflow in .github/workflows/deploy.yml builds the site and publishes dist/ to GitHub Pages.

After pushing to GitHub:

  1. Open the repository settings.
  2. Go to Pages.
  3. Set source to GitHub Actions.
  4. Push to main.

The site URL will be:

https://<your-github-name>.github.io/open-source-portfolio/

If you rename the repository, update base in vite.config.ts.

Project Structure

open-source-portfolio/
├─ public/                    # public visual assets
├─ src/
│  ├─ App.tsx                 # bilingual portfolio content and page structure
│  ├─ App.css                 # page-level styles and responsive layout
│  └─ index.css               # global theme and font setup
├─ .github/workflows/deploy.yml
├─ CONTRIBUTING.md
├─ LICENSE
└─ README.md

Good First Issues

  • Add a resume download button.
  • Add a project detail page.
  • Add a theme switcher.
  • Add a script that rewrites profile data from a JSON file.

License

MIT

About

Bilingual React + Vite portfolio for Aolingge's AI-agent tooling, release proof, and local-first delivery workflows.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors