{"id":20433849,"url":"https://github.com/flashbots/flashbots-writings-website","last_synced_at":"2026-03-12T08:07:46.802Z","repository":{"id":37001855,"uuid":"403267912","full_name":"flashbots/flashbots-writings-website","owner":"flashbots","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-11T16:35:29.000Z","size":103574,"stargazers_count":17,"open_issues_count":13,"forks_count":22,"subscribers_count":22,"default_branch":"main","last_synced_at":"2025-04-12T21:08:53.573Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://writings.flashbots.net/","language":"MDX","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/flashbots.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-09-05T09:35:15.000Z","updated_at":"2025-03-11T16:35:33.000Z","dependencies_parsed_at":"2024-12-09T14:48:55.063Z","dependency_job_id":null,"html_url":"https://github.com/flashbots/flashbots-writings-website","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashbots%2Fflashbots-writings-website","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashbots%2Fflashbots-writings-website/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashbots%2Fflashbots-writings-website/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashbots%2Fflashbots-writings-website/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/flashbots","download_url":"https://codeload.github.com/flashbots/flashbots-writings-website/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248631676,"owners_count":21136562,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-15T08:21:49.367Z","updated_at":"2026-03-12T08:07:41.769Z","avatar_url":"https://github.com/flashbots.png","language":"MDX","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Website\n\nThis website is built using [Docusaurus 2](https://docusaurus.io/), a modern static website generator.\n\nThe live version is hosted at https://writings.flashbots.net\n\n### Getting started\n\nIt's recommended to install the Node.js packages from within a Docker container (installing npm packages can compromise your machine because it can execute arbitrary scripts). You can start the Docker container like this:\n\n```\ndocker run -p 3000:3000 --rm -it -w /mnt -v $(pwd):/mnt node:16 /bin/bash\n```\n\nInstall the dependencies:\n\n```\n$ yarn\n```\n\nBuild the source:\n\nFirst create a copy of `.env.dev` at the root of the project and name it `.env`\nLinux: `cp .env.dev .env`\nWindows: `copy .env.dev .env`\n\n```\n$ yarn start\n```\n\nThis command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server. You can view it now at:\n\nhttp://localhost:3000\n\nTo serve a finally built version (i.e. to double-check the meta tags before publishing):\n\n```\n$ yarn build\n$ yarn serve\n```\n\n### Deployment\n\nCreate a pull-request to the main branch. All changes to the `main` branch are automatically published via Vercel.\n\n### Steps to publish a new post\n\n1. Clone the repository https://github.com/flashbots/flashbots-writings-website and switch to a new branch\n2. If the author has not published on Writings before, add their information in /content/authors.yml\n3. Create a new .mdx-file under `/content/` and include the publishing date in the filename.\n4. Copy the header rows from a previous posts (for instance, [this post](https://raw.githubusercontent.com/flashbots/flashbots-writings-website/main/content/2023-07-24-open-sourcing-flashbots-mev-share-node.mdx))\n5. Edit the content on the header (also called 'front-matter').\n6. Edit the content of the Writings-post. (If you are embedding Dune Dashboards, please follow the instructions [here](https://github.com/flashbots/flashbots-writings-website/pull/138).\n7. Add a `\u003c!--truncate--\u003e` tag around after the first paragraph. All content before that tag will be visible as a preview on https://writings.flashbots.net\n8. Create a new topic on the [forum](https://collective.flashbots.net/) with a summary of the post + CTA, open questions, and discussion topics to encourage conversations. Add the link in the \"forum_link:\"\n9. To preview, install the dependencies as described above and run `yarn start`\n10. Make sure the meta tags and front-matter is in order, and that the post has a nice description and image:\n   * For SEO and previews/sharing, it is recommended to add an image. You can get free images from [https://unsplash.com](unsplash.com) and other pages, but also consider generating an image with [Dall-E](https://labs.openai.com/) and [Stable Diffusion](https://beta.dreamstudio.ai/dream).\n   * The image should be 1200x630px and less than 400kb.\n   * Run images through [ImageOptim](https://imageoptim.com/), as it can significantly decrease filesize, thus speeding up page load time.\n   * Think about a good introduction paragraph, as it will be used in social previews. It will either use the first part of the post, or you can manually set it with the `description: ...` front matter.\n11. Once satisfied, create a PR. Once the PR is merged, the [Github CI system](https://github.com/flashbots/flashbots-writings-website/actions) will automatically deploy it.\n12. Check the sharing meta tags using https://www.opengraph.xyz, and update the content meta tags as needed.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflashbots%2Fflashbots-writings-website","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflashbots%2Fflashbots-writings-website","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflashbots%2Fflashbots-writings-website/lists"}