A single Astro codebase covers three content forms: portfolio, editorial blog, and optional wiki
AstroPortfolioBlog
astro-porfolio-blog-wiki-template — Astro Portfolio Template
By EloyEMC
A reusable Astro-based template that provides three content forms—portfolio, blog, and optional wiki—with sample content and placeholder assets that must be replaced before publishing.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Author preview
Author-provided previewTop of page
Preview provided in the project README.
One original preview is available. Open the full image to inspect the design.
Screenshots show visual appearance; interactive behavior may differ.
Recorded 2026-10-02View source
What stands out
A quick read of the recorded project description.
Site name, URL, description, social links, SEO images, and homepage filters are configured in src/config.ts
Both blog and wiki are managed as Markdown/MDX collections, with content schemas and loaders defined in src/content.config.ts
Built-in search, RSS, sitemap, responsive navigation, SEO metadata, tag and archive routes
The build output is a static dist/ directory, deployable to any static hosting, with optional Cloudflare Pages configuration
MIT licensed, permitting free use, modification, commercial use, and distribution of this version of the code
Template Details
This is a static site template built with Astro that integrates a portfolio, an editorial blog, and an optional wiki into a single codebase. The repository is positioned as a general-purpose starter template and includes sample content and placeholder assets; the README explicitly states that this content is for demonstration only and must be replaced before publishing.
Structurally, site identity and reusable settings are centralized in src/config.ts, author information is in src/authors.js, blog posts are placed in src/content/blog/, wiki entries are placed in src/content/wiki/iluminacion/, and content schemas and loaders are defined in src/content.config.ts. The page layer covers portfolio, blog, tag, archive, API, and wiki routes; the component layer provides shared UI such as navigation, search, SEO, and cards; the layout layer is divided into site, homepage, inner page, and article shells.
The template includes built-in search, RSS, sitemap, responsive navigation, SEO metadata, article layouts, tag and archive routes, and a wiki content schema. The README describes these as extensible starting points rather than finished copy. The repository includes screenshots and a demo video of the reference implementation to illustrate the retained visual direction.
Usage constraints: Node.js >=22.12.0 and npm are required; the local development address is http://localhost:4321; the build output is the dist/ directory, which can be deployed to any static hosting, and the repository also includes an optional Cloudflare Pages configuration (wrangler.toml). The code is MIT licensed, but third-party assets such as demo images, fonts, and icons require separate license verification, and external services such as domains and hosting may incur additional charges.
AstroPortfolioBlog
Is it right for your project?
Use Cases
- Build a personal portfolio with accompanying blog and wiki sections
- Create a searchable wiki content collection for a specific subject area
- Use as an Astro static site starter template, replacing sample content for further development
- Deploy to static hosting (such as Cloudflare Pages) to publish a personal site
Suitable For
- Front-end developers familiar with Astro and Markdown/MDX content collections
- Individual site authors who need a combined portfolio, blog, and wiki structure
- Users willing to replace sample content and placeholder assets and prepare their own branding and legal copy
- Projects using Node.js 22.12.0 or later and managing dependencies with npm
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Requires Node.js >=22.12.0 and npm; run npm install, npm run dev, and npm run build in sequence
- 2
The local development address is http://localhost:4321
- 3
First edit src/config.ts to set the site name, URL, description, social links, SEO images, and homepage filters
- 4
Replace author information in src/authors.js and add your own content under src/content/blog/ and src/content/wiki/iluminacion/
- 5
All URLs, names, social accounts, analytics IDs, and legal text in the repository are examples and must be replaced before publishing; third-party assets such as demo images, fonts, and icons require separate license verification
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version of the public repository under the MIT license; the free scope is the code of this version and does not imply that external services or third-party assets are free.
Must comply with when using
- Free use, modification, commercial use, and distribution of this version of the code are permitted.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- Using this template requires Node.js 22.12.0 or later and npm for dependency management.
- The local development server runs at http://localhost:4321 by default.
- Sample identity information, content, and links in the repository must be replaced before redistribution.
- All URLs, names, social accounts, analytics IDs, and legal text in the repository are examples and must be replaced.
- The template contains only sample content and placeholder assets, which must be replaced before publishing.
- The Cloudflare Pages configuration is optional; using that hosting service may incur external costs.
- Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses and cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur additional charges.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
Requirements: Node.js `>=22.12.0` and npm.
Original README
The local site runs at `http://localhost:4321`.
Original README
Replace the example identity, content, and links before redistribution.
Original README
All URLs, names, social handles, analytics IDs, and legal text in this repository are examples.
Original README
It contains example content and placeholder assets only—replace them before publishing.
Original README
https://github.com/EloyEMC/astro-porfolio-blog-wiki-template/blob/main/LICENSEhttps://github.com/EloyEMC/astro-porfolio-blog-wiki-template/blob/main/README.mdwrangler.toml # Optional Cloudflare Pages settings
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-02. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- Astro Themes
- Documentation and maintenance reference score
- More documented · 76 / 100
- Technologies
- Astro
- Website type
- Portfolio · Blog
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2026-09-19
- Screenshot last checked
- 2026-10-02
No demo link is recorded. Use the repository instructions to evaluate the project locally; the screenshot alone cannot establish interactive behavior.
The catalog identifies Astro as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Automatically checked against source and license rules; no manual editorial review.
Inspect the recorded source material
SHA-256: b4ea6cc99d8c53fe79b8567b42f9540f64a8b0007c76ac9df7b93961cd64d327
2026-10-02T06:33:42.337Z
Source file / repository# Astro Portfolio + Blog + Wiki Template A generic, buildable Astro starter for a portfolio, editorial blog, and optional knowledge wiki. It contains example content and placeholder assets only—replace them before publishing. Created by [Eloy Martínez Cuesta](https://eloymartinezcuesta.com). <p align="center"> <a href="docs/screenshots/home-real.webp"><img src="docs/screenshots/home-real.webp" alt="Home page of the reference implementation" width="1100" /></a> </p> ## Quick start Requirements: Node.js `>=22.12.0` and npm. ```bash npm install npm run dev npm run build ``` The local site runs at `http://localhost:4321`. ## Customization 1. Edit `src/config.ts` for the site name, URL, description, social links, SEO image, and homepage filters. 2. Replace `src/authors.js` with your author profiles. 3. Add Markdown or MDX posts under `src/content/blog/` and update the collection loader in `src/content.config.ts` if you want a different content pattern. 4. Add wiki entries under `src/content/wiki/iluminacion/`, or rename the collection and route for your subject area. 5. Replace the SVG placeholders in `public/` with your own optimized assets. 6. Update navigation and visual tokens in `src/components/` and `src/styles/`. All URLs, names, social handles, analytics IDs, and legal text in this repository are examples. Search, RSS, sitemap, responsive navigation, SEO metadata, article layouts, tag/archive routes, and the wiki pattern are designed to be extended rather than treated as finished product copy. ## Project map ```text src/ ├── components/ # Navigation, search, SEO, cards, and shared UI ├── content/ # Blog and optional wiki Markdown collections ├── layouts/ # Site, home, interior, and article shells ├── pages/ # Portfolio, blog, tags, archive, API, and wiki routes ├── styles/ # Global and page-level styles ├── config.ts # Site identity and reusable settings └── content.config.ts # Content schemas and loaders public/ # Curated generic SVG placeholders astro.config.mjs # Markdown, sitemap, and Tailwind integration wrangler.toml # Optional Cloudflare Pages settings ``` ## Screenshots The repository includes reference captures from the original implementation at [eloymartinezcuesta.com](https://eloymartinezcuesta.com). They show the visual direction the clean template preserves: | Home | Articles | Wiki | | --- | --- | --- | | [](docs/screenshots/home-real.webp) | [](docs/screenshots/articles-real.webp) | [](docs/screenshots/wiki-real.webp) | | Article detail | | --- | | [](docs/screenshots/article-real.webp) | ## Demo video GitHub does not render a YouTube iframe inside a README, so the video is linked through its thumbnail: [](https://youtu.be/IjI0EbcuNrw) The local demo video is also generated from the reference captures as `docs/demo.mp4`. It is intentionally ignored by Git so the repository does not carry a binary video. ## Deployment Run `npm run build` and deploy the generated `dist/` directory to any static host, including Cloudflare Pages. ## License MIT. Copyright © 2026 [Eloy Martínez Cuesta](https://eloymartinezcuesta.com). Replace the example identity, content, and links before redistribution.
Explore similar templates
Compare previews and descriptions within the same stack and category.
astrowind
AstroWind is a free, open-source Astro starter theme using Astro and Tailwind CSS, released under the MIT license.
Astro · Blog
astro-paper
AstroPaper is a minimal, responsive, accessible, and SEO-friendly Astro blog theme. Articles are stored as Markdown/MDX in src/content/posts/, with subdirectories affecting URLs.
Astro · Blog
fuwari
Fuwari is a static blog template built with Astro and Tailwind CSS for personal blogs. It manages posts as Markdown files in src/content/posts/, with frontmatter for title, date, description, cover, tags, categories, draft status, and language.
Astro · Blog
Firefly
Firefly is a clean personal blog theme forked from Astro and Fuwari, offering four background modes, single/double sidebar and list/grid layouts, Pagefind client-side full-text search, and a six-language UI.
Astro · Blog
astro-theme-cactus
Astro Cactus is an Astro-based blog and portfolio theme that uses Markdown/MDX content collections to manage posts, notes, and tags, with frontmatter type-checked by a schema.
Astro · Portfolio
astrofy
Astrofy is a free and open-source personal portfolio website template built with Astro and TailwindCSS, with built-in blog, CV timeline, project showcase, store, and RSS feed modules.
Astro · Portfolio