Taxo Theme Documentation

File Structure

After unzipping the package, the important theme folder is:

• Directorythemes/

  • Directorytaxo/ (Main theme folder)

    • …
• changelog.html
• documentation.html

Main Theme Directory Structure

• Directorytaxo/

  • Directorypublic/

    • Directoryimages/

      • …
    • Directoryvideos/

      • …
    • Directoryplyr/

      • …
  • Directoryscripts/

    • generate-favicons.mjs
    • generate-multilingual-content.mjs
    • remove-draft-from-sitemap.mjs
    • remove-multilingual.mjs
    • toml-watcher.mjs
  • Directorysrc/

    • Directoryassets/

      • Directoryimages/

        • …
    • Directoryconfig/

      • config.toml
      • fonts.json
      • language.json
      • menu.en.json
      • menu.fr.json
      • social.json
    • Directorycontent/

      • Directoryabout-us/

        • …
      • Directoryauthor/

        • …
      • Directoryblog/

        • …
      • Directorycase-studies/

        • …
      • Directorycontact/

        • …
      • Directoryfaq/

        • …
      • Directoryhomepage/

        • …
      • Directorypages/

        • …
      • Directorypricing/

        • …
      • Directorysections/

        • …
      • Directoryservices/

        • …
      • Directoryteam/

        • …
      • Directorytestimonial/

        • …
    • Directoryi18n/

      • en.json
      • fr.json
    • Directorylayouts/

      • Directorycomponents/

        • Directorycards/

          • …
        • Directoryglobal/

          • …
        • Directorysections/

          • …
        • Directoryseo/

          • …
        • Directoryutilities/

          • …
        • Directorywidgets/

          • …
      • Directoryhelpers/

        • …
      • Directoryshortcodes/

        • …
      • Base.astro
    • Directorylib/

      • Directoryutils/

        • …
    • Directorypages/

      • Directory[…lang]/

        • index.astro
        • home-two.astro
        • about.astro
        • contact.astro
        • faq.astro
        • pricing.astro
        • Directoryteam/

          • …
        • Directoryblog/

          • …
        • Directorycase-studies/

          • …
        • Directoryservices/

          • …
        • [page].astro
      • 404.astro
      • robot.txt.ts
    • Directoryplugins/

      • …
    • Directorystyles/

      • …
    • content.config.ts
    • sections.schema.ts

Files You Will Edit Most Often

• src/config/config.toml: logo, title, contact info, multilingual, forms, header button, announcement bar, subscription
• src/config/menu.en.json and src/config/menu.fr.json: main menu, mega menu, footer menus
• src/i18n/en.json and src/i18n/fr.json: shared labels for header, footer, buttons, and common text
• src/content/sections/<language>/: reusable landing-page sections
• src/content/homepage/<language>/: homepage-level metadata
• src/pages/[...lang]/*.astro: page structure, layout selection, and which sections appear on each route

How Taxo Is Organized

Use this rule when customizing the theme:

• src/pages/... decides which sections render
• src/content/... provides editable content data
• src/layouts/components/... controls HTML structure and styling

This structure helps you decide whether you should edit a page file, a content file, or a component.