Cascading News

Cascading News is a website whose purpose is to provide the latest news and tutorials on frontend development.

🚀 How it's built

This site is built using WordPress for the backend, Gatsby + React for the statically generated frontend, and Netlify for awesome hosting and CI.

🧩 Contributing

Useful links

• Github issues board
• Netlify page

🔀 Git flow

1. Fork the repo on GitHub.
2. Create a Feature branch from develop (ex: feature/add-cool-stuff)
3. Commit changes to this branch.
4. Push your work back up to your fork.
5. Submit a Pull request so that we can review your changes and merge it.

Any Pull Request is automatically deployed on Netlify, see Deploy Previews.

Once merged, develop branch is deployed on Netlify. All develop builts are accessible here.

[For repository admins] How to publish a new release:

1. Create a new Release branch from develop (ex: release/1.5.0)
2. On this branch, update version number in package.json and proceed to last fixes.
3. Merge the release branch on master and develop.

Master branch in automatically built by Netlify and deployed on cascading-news.com. All master builts are accessible here

⚛️ Set up

If you want to contribute to the frontend code, here's how to set up the project locally.

1. Checkout this project
2. Create .env.development containing:

   GATSBY_WP_URL=admin.cascading-news.com
   GATSBY_WP_PROTOCOL=https
   GATSBY_REPLACEMENT_URL=http://localhost:8000

3. Install the Gatsby CLI

   npm install -g gatsby-cli
   

4. Start the site in develop mode.

   $ yarn develop

5. Site is now running on http://localhost:8000, and GraphQL client on http://localhost:8000/__graphql.

🔗Links

Unordered list of projects and libraries used for this:

• Wordpress REST API
• RSS Post Importer to automatically fetch * new articles from RSS given feeds.
• Auto Post SchedulerAuto Post Scheduler to publish posts regularly.
• Automatic Post Tagger to add tags to fetched articles based on their titles and contents
• Gatsby, React, TypeScript, GraphQL, Typography for the frontend code
• Gatsby Wordpress Source plugin to use Wordpress REST API as a source for Gatsby static data
• Netlify for continuous delivery and hosting