Phalcon Blog

Phalcon PHP is a web framework delivered as a C extension providing high performance and lower resource consumption.

This is the official Phalcon Blog. You are more than welcome to download the blog and adapt the template to your needs. If you find any typos, we would welcome your feedback and pull requests.

Thanks.

Development

This site is built with Astro. To run it locally, start the container:

./serve -d

The site is then available at http://localhost:4321.

To build the static site:

npm run build

The master branch holds the site source. Cloudflare Pages serves the built site from the production branch, which the CI workflow publishes on every push to master.

Colors and fonts

The colors and the fonts come from phalcon/css/tokens.css in phalcon/assets: the design tokens that every Phalcon site uses. From there also come the code theme (phalcon/css/code-theme.json), the shared nav and footer (phalcon/css/common.css), the footer links (phalcon/footer.json) and the GitHub stars of the nav (phalcon/repositories.json). public/css/tokens.css, src/code-theme.json, public/css/common.css, src/footer.json and src/repositories.json are copies. Every CI run downloads the files again before the tests and the build. When a download fails, or when a file is not correct (for example, a token that the blog uses is missing or has no value, or the theme uses a code role that site.css does not map), the run keeps that committed copy and shows a warning.

• To change a color, change tokens.css in phalcon/assets. The blog gets it on its next CI run.
• To get the new files now, for a local preview or to commit them: docker run --rm -v "$PWD:/app" -w /app node:22-alpine node scripts/update-tokens.mjs. To read them from a local phalcon/assets: --from ../assets/public/phalcon (mount the folder).
• The checks and the refresh are the shared design tools of phalcon/assets: src/lib/design-checks.mjs, src/lib/design-refresh.mjs and src/lib/stars.mjs (the star count of the nav) are copies of phalcon/tools/ there, and every CI run gets them again first. Change them in phalcon/assets, not here.
• public/css/site.css has the blog's own rules. public/css/common.css is the shared nav and footer: do not change the copy. Use a color through the tokens: var(--nd-…) or var(--ph-…). npm test fails on a typed color (#… or rgb(…)) in public/css/ (not in the copy of common.css) and src/.
• The nav (src/components/Header.astro) and the footer (src/components/Footer.astro) are the ones of phalcon.io, with the classes of common.css. The footer links come from src/footer.json. public/js/nav.js is a copy of the mobile menu script of phalcon.io.
• Code blocks use the code theme (src/code-theme.json, set in astro.config.mjs): the rules of GitHub's dark theme with --code-<role> variables. .astro-code in site.css maps them to the syntax tokens of each tone.

Sponsors

Become a sponsor and get your logo on our README on Github with a link to your site. [Become a sponsor]

Backers

Support us with a monthly donation and help us continue our activities. [Become a backer]

License

Phalcon Blog is open-sourced software licensed under the New BSD License. © Phalcon Framework Team and contributors