Skip to content

EMI-Group/evox-portal

Repository files navigation

EvoX Portal

EvoX Portal is the Landing Pages of EvoX, built with Astro 5.0, Tailwind CSS v4, and Iconify.

🚀 Quick Start

Prerequisites

  • Node.js: v18.17.1 or higher
  • pnpm: v8.0.0 or higher (Recommended)

Installation

  1. Clone the repository:

    git clone https://github.com/EMI-Group/evox-portal
    cd evox-portal
  2. Install dependencies:

    pnpm install
  3. Start the development server:

    pnpm run dev

    The site will be available at http://localhost:4321.

🛠️ Components & Architecture

  • Framework: Astro 6 - Selected for its excellent performance and content-first architecture.
  • Styling: Tailwind CSS v4 - Using the latest features including CSS-first configuration and high-performance engine.
  • Icons: astro-icon with Heroicons and Simple Icons sets.
  • Content: Managed via Content Collections for blogs and library metadata.

📁 Project Structure

src/
├── assets/             # Images and static assets
├── components/         # Reusable Astro components (Header, Footer, etc.)
├── content/            # Markdown blogs and JSON library data
│   ├── blogs/          # Blog posts (.md)
│   └── libs.json       # Ecosystem project data
├── layouts/            # Page layouts
├── pages/              # Routing (Home, Blogs, Libraries)
└── styles/             # Global CSS and Tailwind directives

📜 Available Scripts

Script Description
pnpm run dev Starts the local development server with HMR.
pnpm run build Bundles your site into static files for production to ./dist.
pnpm run preview Previews your build locally before deploying.
pnpm astro ... Run any specialized Astro CLI commands.

Development

📰 Writing News

  1. Create a new folder for your news article under src/content/news/ (e.g., src/content/news/my-new-release/).
  2. Inside the folder, create an en.md file with the English content and the required frontmatter.
  3. You can use the \translate skill within your Code Agent (eg: Claude Code) to automatically translate the English article into all supported languages.
    • Ask the assistant: \translate /absolute/path/to/src/content/news/my-new-release/en.md
    • Note: The generated translations serve as a starting point and should be manually reviewed.

📚 Adding a Library

  1. You can add a new library manually by editing src/content/libs.json and adding the corresponding description strings in the locale files.
  2. Recommended: Use the /add-lib skill for an automated workflow. Provide a GitHub URL, and the skill will fetch metadata, update libs.json, and add i18n keys for all locales.
    • Ask the assistant: /add-lib https://github.com/EMI-Group/evox
    • Note: Always review the generated entry and translations.

Built with ❤️ by the EvoX Team.

About

Web Portal of EvoX

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors